£DT - EXTENDED VERSION OF NOS EDIT 
1.0 INTRODUCTION TO EDT 

1.0 iMiQQy£Iiati«IQ-£DI 



EDT is art IfRproved version of the standard NOS 1«3 text 
editor developed by R* Upton* with thanks to CDD division for 
ideas and EOT as a starting point. 

EOT uses all EDIT cofmsands as welt as many new co»«ands and 
extensions to existing cowhands such ass oolumn searches* 
colusnn man i put at ions* lultipte entries on cowmand lines and on 
the EDT control card* 

This icanual wilt describe all of the coaiwands of EOT and 
all of their various options* 

Please bring any errors* omissions or misunderstandings 
reqardin^ this roanual to the author's attention* 
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2.0 TEXT EDITING CONCEPTS 



2.0 I£ll«£aiIIMfi.£QtiC££IS 



This section describes the fundamental concepts and terms 
associated with the Text Editor as a preparation for the 
discussion of the edit session* Included are such subjects as 
Initiating Text Editor* general comaiand syntax* string 
man ipul atlon and columin fflanlpulatlon procedures* 



2.1 ItiIIAIIIifi-.I£lI.£12IiaS 

The user initiates the Text Editor with the EOT command or 
control statement* The format iss 

EOTf if nl# I fn2# I fn3f tabs.cisds 

or 

EDT»FN« lfnl»I»l fn2>L«l fn3#T«tabs*cmds 

The first format is order dependent; the second is order 
independent* The parameters have the folio*«ing valuesJ 

Ifnl The name of the file to be edited* Default is the 
pr imary file* 

Ifn2 The file from tihich the edit commands are to be 
read* For a time-sharing session* default is input 
from the terminal* For a batch Job* default is a 
record In the Job deck (INPUT filel. If Ifn2 « 
then the edit commands Ccmds) are processed and the 
editor will end* If Ifn2 * 1 then the edit commands 
(cmds) are processed and the editor will obtain the 
next command from the file INPUT* 

I f n3 The file on which the output is to be written* For a 
tIme-sharIng session* default is the terminal* For a 
batch job* default Is the file OUTPUT. 

tabs This Is the tabset to be used In EOT* See the TAB 
command for the valid mnenomlcs. 
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2.0 TEXT EDITING CONCEPTS 

2.1 INITATING TEXT EDITOR 



cfltds This Is a series of EOT coiisandls which wM f be 
executed whenever Ifn2 is or 1* Otherwise* this is 



a cowment field* 



2.1.1 If^TERACTIVE USAGE OF EOT 

The ti iae-shar ing user frequently uses default versions of 
the EOT coiamand. ThuSf the entry 

EOT 

calls EOT and performs editing on the primary file with 
directives entered at the terminal. Output is printed at the 
terminai using the existing character set mode* 

The default entry 

EOTflfn 

calls the editor and performs editing on the local file I f n 
with directives entered at the terminal. Output is printed at 
the terminal using the existing character wode. After the EOT 
command Is entered* the system replies: 

3EGIN TEXT EDITING. 
? 

This message Indicates that the editor program is initiated 
and awaiting commands. The message will not appear if Ifn2 « 
0. The program is designed to process only the editor 
commands discussed In section 3 of this manual. Thus* the 
regular time-sharing commands are illegal until an exit Is 
made from the editor. It may be necessary to enter and exit 
the editor several times during an editing session in order to 
use features not available under EOT control trefer to 
Terminating Editing Session at the end of section 3). 

The text editor way be called from any of the time-sharing 
subsystems. 



2,1.2 BATCH USAGE OF EOT 



EOT can fee used by a batch job If it includes the EOT 
control statement In Its control statement record. Batch 
usage of EOT requires that the job deck be properly structured 
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to ensure that the correct records are read froia the job INPUT 
file or that they are available as local files* Refer to the 
NOS Reference Manual* volume 1 for a complete discussion of 
batch job structure* 

For example* suppose a batch job contains a record listing 
six types of cable assemblies and the asiounts on hand. The 
job calls on EOT to produce two listings of specific types. 
The deck Is shown In figure 2.1. The cable list Is the second 
record in the INPUT file. This Is copied to a local file and 
given the name PARTS. 

CABLES. 

US£R( usernaiBf passMor* f am) 

CHARGECchargenOf project) 

CQPYCRC#PARTS) 

EOT(PARTSffTEHPI 

COPYSBFiTEHP*) 

end-of-r ecord 

CABtE*4-WlREf6-FQ0T QN^HAND 22 

CABLE* V-WIRE*8-F00T ON-HAND 09 

CA3L£*6-WIRE*6-FQ0T ON-HAND 03 

CABLE#6-MIRE*8-F00T ON-HAND 11 

CABLE* 8-WIRE#6-F0QT ON-HAND 01 

CA8LE*8-WIRE*8-F0QT QN-HAND 19 

end-of-record 

LIST2/6-FOQT/5* 

LIST/B-WIRE/* 

END 

end-of-informat I on 

The Input file can also appear as follows to get the same 
results. 

C ABL ES . 

USERCusernaiR*passwor I 

C HARGE I chargeno* project) 

COPYCR C * PARTS ) 

£0TCPARTS*0*TEMPRISTs/6-f0QT/J*.LIST/8-«IR£/* 

C0PyS8F<T£MP*l 

end-of-record 

CABLE* 4-yiRE*6-fQQT ON-HAND 22 

CABLE»4-\^IRE*8-FQ0T ON-HAND 09 

CABLE*6-MIRE»6-FQ0T ON-HAND 03 

CA8LE*6-MIRE*8-F0QT ON-HAND 11 

CA8L£*8-MIRE*6-F00T ON-HAND 01 

CABLE* 8-WIRE*8-F00T ON-HAND 19 

end-of-inforraation 
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Printout from execution 
of the prececding job 

BEGIM TEXT EDITING. 

CABL£»4-WIREf6-FQ3T ON-HAND 22 
CABl£f6-WIRE»6«F00T QN-HANO 03 
CABLE* 8-WlREf 6-FOOT QN-HANO 01 
-BHQ OF FIIE- 

CABlEf 8-MIR£f6-F0QT ON-HANO 01 
CA8l€»8-WIREf8-FQQT QN-HANO 19 
-END OF FILE- 
END TEXT EDITING. 

Figure 2-1. Batch job using EOT 

The EOT control statement references PARTS which is rewound 
by EOT. The »iode of file processing is the current roode 
(normal }* The missing parameter after the cowmaf In case 1» 
indicates the source default of INPUT. Therefore* the editing 
cofnmands are taken from the next record in the job deck 
(foltOMing the list of six cablesi* In case two* the editing 
commands are taken from the EOT control card C after the ( or 

TEMP Identifies a temporary file on which the results of 
editing are written. These results are not routed directly to 
the printer since* at this point* allowance has not been made 
for carriage control by the first character of each line. 

The temporary file TEMP is copied to the OUTPUT file with a 

CQPYS8F control statement* which moves the text oyer one 

column leaying the first position of each line blank* This 
causes single spacing. 



2.1.3 ADDITIONAL CONSIDERATIONS 



It is possible to enter EOT with an empty file and develop 
it during the edit session (refer to Adding and Building Text 
In section 3) 

EOT operates on a single record only* If It is 
entered with a multi-record file* all but the 
first record is lost Crefer to the NOS 
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Time-Sharing Users flanuai or the lAF Reference 
Hanuaiy section 3» File Sorting)* 

EOT operates on files containing no more than 
131f071 (377*777 octal) lines. Reference to 
tines beyond this gives unpredictable results* 

Some EOT commands are powerful and can ruin a 
file if i Improperly used* Therefore* the user 
should have a copy of the file being edited* To 
create a copy of a direct access file of local 
filet refer to COPY control statements* NOS 
Reference Manual* voluwe 1* A working file can 
be saved prior to* or during editing* 



2.2 £aiI.£iU 



The editor operates on only one edit file at any given 

time. The edit file can be the primary file* a working file* 

or a direct access permanent file and is specified when 

entering EOT with the EOT cofflsiand* All changes to the edit 

file are reflected in the original working file or direct 
access file* The edit file has a line limit of 150 
characters. Lines longer than 150 characters are truncated* 

Editing a read-only file may cause unpredictable 
resul ts* 



2.3 S£MCa«EQiMI£a 



The search pointer is a place marker that indicates a 
particular line of the edit file* Unless command parameters 
Indicate otherwise* the operation Implied by the command word 
is performed on the line indicated by the search pointer* In 
any case* all action on a file begins relative to the search 
poi nter • 

The search pointer is set at the beginning of the edit file 
when EOT is initiated* The SET* FIND* RESET* and LENGTH 
commands are used to change its value* and are the only 
commands capable of doing so* 

A command that operates on more than one line of the edit 
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file always begins operation at the line indicated by the 
search pointer <0f relative to that I inel. 



2.4 &QI«CatlllAtiaS.lii£tl££AL.£QB{IAIl 



Each editing operation on an edit file is specified by an 
edit coiBiRand. The following elements are possible In an edit 
contitnand* 

• Coffifliand word 

This Is the manditory first element. It can be any 
one of the EOT comiBands of a short form thereoft as 
listed in the Comfnands Words section. 

• String specification 

A string consists of a nonzero number of 
al phanumber ic characters bounded on each end by a 
non-blank character (called a delimiter). In most 
commands* the string identifies the part of the file 
being sought* added to* or changed. <In the HERGE* 
REPLACE* SAVE and LOCAL commands* the string Is a 
file name.) The delimiters on each end of the string 
must be the save character* must not be the character 
$ or blank* and cannot be used within the string. 
The command terminator Iby default a .) cannot be 
used within the second string using the third form of 
the syntax* as well. (The / is arbitrarily used in 
the formats to designate the delimiting character.) 

A string specification must immediately follow either 
a) a colon* b) a comma or c) a delimiter. If two 
string specifications are included In a command* they 
may be separated by a comma and a delimiter or start 
immediately after the delimiter. NOTE in the third 
form a command terminator may NOT be used in the 
second string. The forms of a string specification 
ares 

omitted 

5/strlng/ or */string/ or /string/ CI) 

s/string/f /string/ or */strl ng/*/str ing/ (21 
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/string/string/ (3) 

Coiuisn specification 

String specifications can also be bounded by the 
columns* Coiuinn specifications xill limit the string 
searches to the specific columns nientloned in the 
command* When the columns are specified they nil I 
override the current default limits set by the user* 

The column specification must have delimiters on each 
end* A semi-»colon Is optional* There must be t«o 
delimiters between the last string character and the 
first column descriptor* The forms of the column 
specification ares 

omitted 

;/col/ or /col/ 

Beginning column searches 

The column specifier* by default* locates the strings 
In which only the first character resides within the 
indicated columns* The 8 option causes EOT to locate 
a string which completely resides within the 
indicated columns* This feature has the following 
forms 5 

omi tted 

/b or Jb 

Delimited searches 

This option will allow any string searches to look 
for only strings which have a character that is not 
al phanumber Ic on each side of It* The beginning of 
line and end of line are treated as 
non-alphanumber Ic* The delimited string specifier 
has the following forms s 

omitted 

/d or Jd 

n parameter 

This indicates the number of times the particular 
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edit operation is to be applied, n can be an integer 
or an asterisk. The Integer must be positive for all 
commands except SET and FIND> which can use positive 
or negative values. An asterisk caused the operation 
to be repeated from the current position of the 
search pointer to the end of the fife. 

An n parameter specification may follow a semicolon. 
The forms of this specification ares 

omitted 

f n or n 

I* or ♦ 

• Comment 

An optional comment can appear as the last element in 
an EOT command sequence. It Is introduced by a $ and 
consists of any sequence of characters that can fit 
on the remainder of the line. Comment has no effect 
on the operation of the command. 

Each commands including a possible commentf must be 
contained within a single line. Each element must appear In 
the sequence shown* although not every element need appear. 
Generallyf columns specification cannot occur without a string 
specification CDC command is the exceptionl. Delimited string 
specifier MUST have a string specifier to be of any use. 
Otherwise any element* except the command* may be left out* 
The square brackets ICt 31 indicate the limits of each 
element. Pressing the carriage return initiates the operation 
of the command. 

cmd Cs/stringl/ C»/string2/1 J C |/col / J C I d Cbl 3 IlnJ CScomml 

or 

cmd C#/stringl/ C#/string2/3 ICl/col/l CId Cb3 3 £|n1 C$comm3 

or 

cmd C/strlngl/ Cstring2/3 3 C/col/3 C/d Cb3 3 Cnl C$comment3 
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2.4.1 LINE MODE AND STRING MODE 



Some edit conifflands have two modes of operationt line mode 
and string mode. In a line mode command* all operations are 
performed with a line of edit file as the basic unit of 
operation. The string may be a portion of a line or may 
extend over several lines* 

mu 

It is important not to confuse string mode 
with the search string used in both line 
mode and string mode edit commands. The 
search string specifies the point or area 
of the edit file to which the command 
operation Is directed. The string mode 
refers to the nature of the command 
operation. 



A string mode 
specification has the 
mode command. 



command with an empty search string 
same action as the corresponding line 



2.5 aOBiAtia.MOEO 



The command 
The EOT command 
short forms fif 



word deten 
words are 
any) shown 



ines the operation to be performed, 
listed with their corresponding 
in parentheses* 



LiQ£.£aiaaiii.ia££is Sttiai^Caiiaail^Macls 



ADD 


(Al 


BLANK 


(Bl 


CHANGE 


CCI 


DELETE 


CO) 


EXTRACT 


(El 


FIND 


(F) 


LIST 


CD 


NUN8ER 


CN) 



ADDC 
ASCII 



ADDS 


CAS) 


BLANKS 


CBS) 


CHANGES 


CCS) 


DELETES 


CDS) 


ES 




FINOS 


CFS) 


INSERTS 


CIS) 


LISTS 


CLS) 


NUMBERS 


CNS) 


RS 





C2itLai.Caiitnil.M2i:iis 



CAC) 



ECHO 
EXd 
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ALIGN 


(AL) 


LISTA8 


(LT> 


BREAK 




LISTC 


(LC) 


C8d 




LOCAL 




CHANGEC 


(CCI 


MERGE 


(M) 


CEQL 




MERGEL 


<ML) 


CLEAR 


(CD 


NORMAL 




COLUMN 


tCQLI 


RESET 


<R) 


DEFTAB 


(DTI 


REPLACE 




DELETEC 


(DC) 


SAVE 




DEOL 




SET 


(S) 


END 




TAB 


(T) 


LENGTH 




TERM 




LINE 


(LN) 


WIDTH 


(y) 



2.6 iI£lJlSi«AMfi-Q£iIMII£SS 



A string is a sequence of atphanufliber Ic characters that may 
include blanks and special characters. Strings are used in 
tMo ways* 

• In the string specification of a EOT coiamand 

« In response to an ENTER TEXT retfuest 

The two ends of the string wust be explicitly defined by a 
pair of watching characters called delimiters* A deliraiter is 
any nonblank character except a dollar sign l$l and Is chosen 
by the user* 

In the third version of the string format* there are three 
additional restrictions in the second string* These ares CI) 
the first character cannot be a sesi-colonf (2) a command 
terminator cannot be in the string* and (3) a comm^ cannot be 
the only character* 

The delimiter character can be used *#ithin the string only 
in response to an ENTER TEXT request* If* however* such an 
embedded character {identical to the delifsiter character) 
appears at the end of a line Cfor exawple* the fast character 
entered pr oir to a carriage return)* EOT interpets the 
character as the closing deHwiter and the ENTER TEXT request 
is terminated* EOT tests for the closing deliialter only after 
a carriage return* 

Use of the delimiter character within the string definition 
of an EOT command is not allowed and If used* EOT responds? 
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See NOTE for warning of 
this delimiter 



cowwand SYNTAX ERR3R. 

<In this manual the character / is used to 
delimiter in the presentation of cofflfliand formats.l 



/ABCDE/ 

/THE FORHAT OF/ 

BALWAYS IS B 

? INT(R*TAN{2*MH? 

/THIS STATEMENT WILL 
(HOyEVER) 

ANY COMMAND TERMINATED BY/ 

$THIS LOOKS LIKE A COMMENTS 

/FIND/I IN THE PHRASE / 

/CHANGE/*/ 
/DELETE/THE ./ 



denote a 



del i mi ter 
begi nning 
del imi ter 



(no closing delimiter) 

(different 

characters) 

(unintended 

del iiui ter ) 

(i I legal 

character) 

(a semi -col on is first 

character in second 

string) 

(cofli^a only character 

in second string) 

(period Is default 

command terminator and 

Is In second string) 

mm 



Iiaproper or unintended string definitions 
are common error S9 and because of the 
powerful nature of some EDT commands* are 
potentially destructive to a file. 

In version 3 of the string format an 
alphabetic character cannot be a 
delimiter* Whenever the colon or comma 
separates the command and the string an 
alphabetic character can be a delimiter* 
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2.7 a£4ai:a.iiEi(i£.£4aM£i£B 

The search string parameter of an EDT command indicates to 
the editor where the operation is to be perforaed. If no 
search string Is given In a command* the operational location 
depends solely on the setting of the search pointer* If a 
search string Is given* the operation specified Is performed 
with respect to the first occurrence of the string after the 
beginning of the line Indicated by the search pointer* 

If the specified string does not occur after the beginning 
of the line indicated by the search pointer* the following 
message is printed* 

PHRASE NOT FOUND. 

The search string must be specified to Identify uniquely 
the string being sought* If too siaall a string Is given* the 
search may result In operating on an occurrence of the string 
that was not the Intended target* 

A search string is given in two forms* a single phrase of 
nn el I ipsls. 



2.7.1 SINGLE PHRASE SEARCH STRING 

In a single phrase search string* the entire string on 
consecutive characters Is placed between a pair of 
delimiters. The string can Include as many characters as 
required (subject to the requirement that the entire command 
be on a single line)* and the search Is satisfied only when an 
identical string Is found within a single line of the edit 
file. 



2.7.2 ELLIPSIS SEARCH STRING 

An ellipsis string specification consists of two delimited 
bracKet strings»in one of the two previously described 
formats. The search process attempts to locate a string of 
consecutive characters that begins with the first phrase and 
ends with the second phrase* The string Implied by an 
ellipsis search string may appear in the file over more than 
one I Ine. 

Examples 

The ellipsis search string 



EOT - EXTEMDEO VERSION OF NQS EDIT 



2-13 

06 AUG 80 



2.0 TEXT EOITING CONCEPTS 
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:/FQRM/f /LONG/ or /FORM/LONG/ 
is satisfied by the string underlined* 

THE ELLIPSIS IS A EQaU^QE.itiQEiaMa^EQE-iQtifi OR HULTILINE 
STRINGS. 

One f refluent source of error in using ellipsis search 
strings is a tendency to make the bracket strings too short* 
Consider the following text* 

AN ANOTHER EXAHPLE, ASSUME THAT laS.IMfiEI.SiaiMfi-EXIEIiQS 
Q^EE^iE^ESAi.LiyES.LIHE.iaiS^aME- 

If the underlined string Is to be referenced* a command 
nith the foilonlng string specification might be entered* 

s/THE/»/ONE/ or /THE/ONE/ 

This does not reference the string desired* however* 
because the first occurrence of THE is in the word ANOTHER* 
The string specification 

s/THE T/*/QNE/ or /THE T/ONE/ 

identifies the underlined string properly* 

2.7.3 SPECIAL STRING FIELD 

A special string has a format similar to that of a search 
string. Its Interpretation depends on the corowand word with 
which it appears. The following are the six types of special 
string fields and the statements with which they are used. 

« Tab stop sequence In a TAB coiswand 

« Tab character defined In a DEFTAS comrsand 

. A file nar«e In a HERGE* LOCAL* REPLACE or SAVE command 

. A cotuflin search sequence In a COL cowhand 

• A series of EOT commands In a CBx coi6!iKand 

« The length of a truncated file In a LENGTH coaifiind 

2.8 aQLyHi-lEMUMES 

This string Is used to llait the string searches to certain 
columns within the edit file. The structure of the string Is 

J/C3L/ Cll 
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/COL/ 12) 

Irj format 2 there iHust be two deHiuiters In a row* The 
forfliat of the COL parameter has four formats* These ares 

C0L1#C0L2 Search from CQLl to CQL2 

COL Search the one column COL only 

#COL Search from the current default starting 

column (by default set to 1 or set by CQL 

cofflmandl to column COL* 
COLf Search from the column CQL to the default 

end column search <by default end of line 

or set by COL command) 

If the column search Is used in conjunction with a string 
search^ then the first character of the string must be within 
the columns indicated to be found. If the column search Is 
used with an ellipsis string^ then the string which Is found 
is the first one In which the beginning and ending strings are 
within the columns specified. This string could be a 
completely different string than is desired. 

By default* EOT will locate strings in which only the first 
character must be within the columns indicated. Sometimes It 
is useful th specify that the whole string must be within the 
indicated columns* The letter 8 Is used to indicate that the 
whole string must be within the columns. 

lb CD 

/ b 12) 

In format 2 there must be two delimiters in a row. 
A delimiter Is NOT used If «b» follows a M'. 

Example 

If the edit fife contains the following: 

123456789 

ABCOEFG 
ABCDEFG 
ASCOEFG 
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then the cofflwand: 

8/ABCDEFG//2//8 

Mill change the file to the fofloMlng: 

123456789 

ABCDEFS 

ABCOEFG 
Only the third line is blanked. 

2.10 a£uaii£o.siaiMa.s.£Aaaa£s 

A delimited string Is a string which is proceeded and 
suceeded by a character that Is not a letter a nuwber or a 
colon* When this option is used* it will ensure that all 
string manipulations will occur only on delimited strings* 
Beginning of line and en4 of line are also considered 
deliiiiters* The foraiat of the option Is? 

Id CI) 

/d C2I 

In format 2 there must be two delimiters in a row* 
A delimiter is NOT used If «d« follows a 'b** 

Example 

If the edit file is the follOMing: 

ABCDE 

?ABC? 

A8C 

then the commands 

t/A8C//D* 

Mill list the following 

?ABC? 
ABC 

but not the line ABCDE* 
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2.11 il.£A&Ai£I£E 

The n paraiseter is an integer Nhose leaning depends on the 
context in which it appearsi its use adds flexibility to EDT 
commands. The following are the possible interpetat Ions. 

• The number of lines on which a cosimand Is to be 
performed 

• The number of strings on which a command Is to be 
performed 

• The number of lines the search pointer is to be moved 
forward or backward 

« The maximum width of the lines in character columns 

• The point in a file where new data Is to be Inserted 

When omittedf n is assumed to egual 1 if applicable, the n 
parameter is not appticibte for the commands RESET* LINE* 
tISTAB, ClEARf NUMBERCSIt DEFTAB* CBxt LENGTH* ASCII* BREAK* 
COL* ECHO* LOCAL* NORMAL* REPLACE* SAVE* TERM* and END. 
Negative values of n are allowed only in a SET or FIND 
command. 

An asterisk <♦) instead of a number in the n parameter 
Indicates that the operation is performed at or until the end 
of the edit file. Refer to the description of the particular 
command of Interest for specific details. 



2.12 QQCyS£aUSX.£QaM£liIS 

To annotate the editing session (possibly for review 
purposes) append a dollar sign with commentary Information. 
The comment is ignored by the editor. 



2.13 £Qia4t4l2l-UII£ 

A line of EDT Input can consist of more than one command. 
Commands are separated by a terminator (by default a period I. 

EDT looks for a terminator outside of the string 
specifications. There is one exception* whenever the third 
format of the string definition (/str I ngl/str Ing2/ I Is used* \ 
the second string is scanned for a terminator. If this is a - 
problem use formats one or two or see the next paragraph. 
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A local terminator can be used to get around the use of a 
terminator In a string of a cowmand. The focal terminator Is 
In effect for one line only* It is specified with a 
non-alphabetic character as the first character in the line of 
input* EOT will then scan the line for this new terminator* 

When the global terminator appears by itself on the command 
line* then the last line of Input is repeated* 

Examples 

L/LIST/.F/STRING/ 
?L/IIST/?F/STRING/ 



2.1^ SIEIMS.fiil£££E 

The string buffer is a temporary storage for information 
that Is to be moved »#ithln the edit file* 

Information is copied from the edit file Into the string 

buffer using the EXTRACT command* This information can be 

kept as a local file when the edit session Is ended by the 

LOCAL command or may be Inserted elsewhere In the file* using 
the ADD or CHANGE command. 

After the ADD or CHANGE command Is entered* the system 
responds: 

ENTER TEXT. 
I 

IF the user responds by typing 

$ 

on the same line» the contents of the string buffer are 
Inserted into the edit file at the point or points Indicated 
by the ADO or CHANGE command* 

The CLEAR command erases the contents of the string 
buffer* CLEAR Is used whenever the contents of the string 
buffer Is no longer nee4e(im Until a CLEAR command Is issued* 
repeated EXTRACT operations cause extracted strings to appear 
cumulatively in the string buffer* concatenated in the order 
of their extraction* 
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2, 15 £iii£a.i£ii.i£ay£Si 

The text editor issues an ENTER TEXT request in reponse to 
an ADD comiiiand and fn response to a CHA^^GE cowiaand. 

After the ENTER TEXT request* type an opening deliwiterf 
foi loMed by the body of text to be entered* and then folloned 
by a closlna delimiter* The delliiters do not becowe part of 
the actual file* 

The delimiter character Is the first non-blank character 
entered in reponse to the ENTER TEXT request. The closing 
delimiter Is the first recurrence of the deliiaiter character 
that Is follo*«ed Imnjedi atel y by a carriage return. The 
delimiter character may occur in the actual text if it is not 
ipmedlately followed by a carriage return. 

The delimiter »ay be any non-blank character except a 
dollar sign ($)• If a blank or a dollar sign is entered as a 
delimiter from an interactive job* EOT responds wlthJ 

ItlEGAl DELIMITER - REENTER TEXT. 
? 

For a local or remote batch job* EOT issues the fo!lo*«ing 
error message to the user's dayfile 

ItlEGAl DEIIHITER. 

expecting the next statement in the INPUT file to be a new 
command* 

For time-sharing origin jobs* the text editor types a 
question mark at the beginning of each line until the closing 
del Imi-ter appears. The system then responds! 

READY. 
t 

The READY message Indicates that the next line entered Is 
treated as an edit command. 

If a blank line is desired In the text* at least one space 
must be entered on a line and then followed with a carriage 
return. If the closing delimiter followed with a carriage 
return ^ppe^rs on a line by Itself* a blank line Is added to 
the text file. If this method is used by an lAF user* the 
closing delimiter cannot be the terminal control character or 
any other character recognized as a terminal def I nation 
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2.15 ENTER TEXT REQUEST 



coffifnand (refer to the lAF Reference Hanual). If a carriage 
return alone is entered on a tinef a final blank tine is added 
to the texty and an exit from the enter text mode occurs (that 
is> a return to conniand mode). If two dellwlters alone appear 
on the input line* then nothing happens to the text file and a 
return to comnand mode Is Issued. 



2.16 £Eiic£SsiM£-.i£aEiti^L-iii££&ay£ia 

The tiiBe-shar ing user way control his edit session with 
terminal Interrupts. The BREAK command allows the user to 
turn off the Interrupt control so that any interrupt the user 
issues will abort edit session. By default an Interrupt will 
not abort the edit session. When the interrupt Is turned on* 
there are three ways to use interrupts. 

• While output Is being trans«itted to the terminal. 
The lAF user terailnates the transmission of output to 
the terminal by entering the interruption or 
termination sequence (refer to the lAF Reference 
Hanuafl. (In some manuals^ these are also referred 
to as the user break 1 and user break 2 sequences* 
respectively! All other time-sharing users perform 
this interruption either by pressing the BREAK* I or 
S key (on an ASCII code terminal) or by pressing the 
ATTN key (on a correspondence code terminal). One of 
the main uses of this Interrupt is the termination of 
unwanted output from execution of a LIST command. 

« While the user is entering text in response to an ADO 
or CHANGE command. 

After entering text in response to and ADD or CHANGE 
command* the lAF user enters the Interruption or 
termination sequence* and any other time-sharing user 
types STOP or presses the BREAK key (on an ASCII code 
terminal) or ATTN key (on a correspondence code 
terminal) at the beginning of a line to terminate the 
command. The user is given the choice of retaining 
or discarding the text just entered. The system does 
this by typings 

DISREGARD PREVIOUS TEXT ? 

If the user types NO after the question mark the 
system responds wlths 

READY. 
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In this case* tfie text entered Is included in the 
edit file* and the system awaits a new edit command* 

If the user types YES In response to the question* 
the system responds with: 

READY, 
1 

The text just entered is disregarded* and the system 
awaits a new edit command* 

If the user attempts to interrupt or terminate the 
question* it is treated as an END command* and the 
editor terminates* 

While the system is processing a command* The lAE 
user enters the Interruption or termination sequence* 
and all other time-sharing users type STOP or press 
the BREAK key Con an ASCII code terminal) or ATTN Con 
a correspondence code terminal I at the beginning of a 
line to terminate the execution of an edit command* 
The system gives the output status of the command In 
execution by printings 

INTERRUPT AT LINE n. 

The output status Is then followed by the enquiry? 

COHHANO CONTINUE? 

If the user types YES after the question mark* 
processing continues* if he types NO* the system 
prints a line indicating how far the command was 
processed* and processing terminates* 

MaiE 

Entering the termination sequence 
or typing STOP after the 
execution of an edit command 
Immediately terminates the edit 
session Crefer to TERMINATING 
EDIT SESSION)* 
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3.0 EQi.cQiaaAiias 



This section describes the allocable formats for each text 
editor cowmand and rules governing their use. The coaiwands 
are grouped by general category of function* for exanplef the 
removal of Information category Includes OEIETE and BIANK 
commands* 

A group of contextual examples Is Included at the end of 
each category* These examples are designed to illustrate the 
effect of the various formats* and in particulart to clarify 
the differences between simltlar commands* 

Most commands will be Illustrated using the longer syntax 
but the short syntax will also work* 

Ail commands without an explicitly mentioned column 
specification may use the column and/or delimited string 
specifications when a search string is used* 



3.1 £tiI£EiaS.£aBI3il^ll5l 

AH editor commands are entered at the time-sharing 
terminal or Included in a batch job according to the general 
format described In section 2 of this manual* After an edit 
Input line is typed and the carriage return is pressed* the 
editor either processes the commands immediately or requests 
additional information* In generals each edit command 
operation Is performed relative to the current search 
pointer* Chapter 4 contains a summary of all EOT messages and 
requests* 
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3.0 EOT COMMANDS 

3,2 TEXT LISTING AND SEARCH POINTER CONTROL 



3.2 lEZI^USIIMfi- AISQ-.se AE(ia«£QIM£E-CQiI&QL 



3.2a LIST COMMAND 

The LIST cowmand alloMs the operator to print all or 
selected portions of the edit file* the printout can include 
a string of char act ers» a single line* a set of lines each 
including a common character* or a set of contiguous lines* 
Execution of the LIST cosawand does not change the position of 
the search pointer* 

If an asterisk Is specified in the n parameter or If the 
value of the n parameter extends beyond the end of the edit 
file* alt remaining lines are printed* foltoMed by 

-END OF FILE- 

If an ellipsis string is specified* a line mode command 
causes all lines to be printed that contain any portion of the 
ellipsis string* A string mode command prints only the string 
implied by the ellipsis* 

3.2.1* 1 Liafi«l3ailfi-£fl£iais-iLIiI-at-ii 

daiiaoiii Eiaiaoiaiiiiia 



LIST 



LISTin 



Prints the 
sped f i ed 
poi nter* 



line of 

by the 



text 
seach 



pr i nts n I ines of 
text* beginning at 
search pointer* Clf 
eciuals ^9 all lines to 
end of the edi t file 
printed* > 



conti guous 

the 

n 

the 

are 



LISTs/string/ 



LIST!/stringl/*/stri ng2/ 



Prints the line containing 
the specified string Cthe 
phrase must be contained in 
a single line)* Search for 
string begins at the current 
position of the search 
pointer* 

Prints the line or group of 
lines containing the 



EDT - EXTENDED VERSION Of NOS EDIT 



3-3 

06 AUG 80 



3,0 EDT COHHANDS 

3«2.1,1 Line Mode Formats (LIST of LI 



eliipsis 
/strlngl/#/str ln<i2/» 

LIST/str ingl/string2/n Prints the first n 

occurrances of lines or 
groyp of lines containing 
the el I Ipsi s 

/stri ngl/str ingZ/ 

3 • 2 . 1 • 2 St£ia5«!lailfi«£aLiJti-iLiaiS-fl£-Uai 

LISTS Sarae as LIST 

LlSTSn Same as LISTjn 

LISTS/str ing/ Prints the specified string* 

If present in the edit 
file. Search for string 
begins at current position 
of search pointer* 

LISTSf/str ing/;n Prints the first n 

occurrences of the string* 

LISTSs/str lngl/»/str Ing2/ Prints the string of 

characters specified by the 
ellipsis 
/stringl/f/strlng2/. 

LISTS/stringl/strlng2/n Prints the first n 

occurrances of the string of 
characters specified by the 
ellipsis /str Ingl/string2/. 

3.2*2 SEARCH POINTER CONTROL (SET AND RESETI 

EDT initially locates the search pointer at the first line 
of the edit file* yith the SET cowiBandf the seach pointer can 
be moved to a particular line in the edit file without listing 
It* The RESET cotfimand sets the search pointer to the first 
line of the edit flle» regardless of its former position* 
Activity on the edit file always begins at the current search 
pointer setting* 
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3*2«2*I SET CoaifliancI (SET or S) 

Ttie foi lowing are the four forms of the SET command* 

SET Advances the search pointer 

one line relative to its 
current setting. 

SET- Sets the search pointer back 

one line from the current 
position* 

SETin or SET-n Advances Cor sets back I the 

search pointer n lines 
relative to Its current 
setting. If the SET 
instruction results In a 
negative search pointer {the 
pointer being set back past 
the beginning of the file)* 
the pointer is set to the 
first fine. (If n e<iuats ♦ 
or extends beyond the end of 
the file* the pointer Is set 
to the end of the edit 
file. I 

SET/string/ Advances the search pointer 

to the line containing the 
string* relative to the 
current setting of the 
search polnteri if the 
current line contains the 
string the search pointer is 
not !»oved. 

SET* /str ing/in Advances the search pointer 

frofR its current setting to 
the beginning of the nth 
line containing one or more 
occurrences of the search 
string! if there are less 
than n lines containing at 
least one occurrence* the 
search pointer Is positioned 
at the last line containing 
the string. 

The SET command requires locational information. If no 
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search string is present* the use of the n parameter is 
liepi ied* 

Only single-phrase search strings are allowed* Ellipsis 
search strings are not allowed* 

3.2.2*2 &£S£I-.C2iia Qil.LS£S£I-a£.«Ei 

The RESET coiaisand brings the serach pointer to the 
beginning of the edit file* Its foriaat Iss 

RESET 

Operational fields are not used with the RESET coiBwand* 

3.2.3 FIND COMHANO 

The FIND command scans the edit file* beginning at the line 
indicated by the search pointer* When a line <or string) is 
encountered that fulfills the combined requirements of the 
search string and/or the n parametert the editor lists that 
line or string and sets the search pointer accordingly (as 
explained In the discussion of the FIND formats). 

If the ef^ti of the edit file is reached before the nth 
occurrence Is found* the search pointer Is set to the line of 
the last string found* 

3*2*3.1 ilQS^Miis.Eatia ts.iEiMfi-at-El 

FIND Advances the search pointer 

one line and lists the 
I ine* 

FINDl- Sets back the search pointer 

one line and lists the 
line* 

FINDn or FINO-n Advances (or sets back) the 

search pointer n lines and 
lists the line Indicated by 
the new value of the search 
pointer* 

FIND5/str Ing/ Advances the search pointer 



EOT - EXTENDED VERSION OF NOS EDIT 



3-6 

06 AUG 80 



3.0 EOT CONflANOS 

3.2«3*1 line Mode Formats CFIND or F) 



FINO>/str Ing/n 



FIN0/stringl/stflng2/ 



FIN05/strlngl/#/strlng2/5n 



to the line that contains 
the string. 

Advances the search pointer 
to the nth line that 
contains at least one 
occurrence of the string and 
lists the line* n must be 
posi ti ye* 

Advances the search pointer 
from Its current position to 
the first line that contains 
the beginning of the 
ellipsis search string* If 
the search string Is 
wul tl •! I ne# all I Ine 
containing some part of 
/str Ingl/str Ing2/ are 
I Is ted* 

Advances the search pointer 
to the nth line which has 



the 



beg I nning 



ellipsis 
I IneCs) 
elf I PS Is* 
positive* 

3*2.3*2 St£lQa^!iad§ -£aLiai;s-i£iiaS«ac-£Si 



and 
that 
n 



of 

I ists 

has 

must 



the 

the 

the 

be 



FINDS 
FIHDSin 

FINDS/string/n 



FINDS/str Ingl/str I ng2/|n 



EMiaoaiiaa 

S a»e as FIND* 

Same as FINDln* 
be positive* 



but 



lUSt 



Advances the search pointer 
to the line containing the 
nth occurrence (If 
specif I edf otherMise the 
first) of /string/ and lists 
the str Ing* 

Advances the search pointer 
to the line containing the 
beginning of the nth 
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3«2«3«2 String Mode Formats CFINDS or FS ) 



occurrence of 

/strlngl/string2/» The 
string i s f isted* 



3.2.4 CINE COH«ANO CtlNE OF IN) 

The LINE command causes a message to be printed that gives 
the current setting of the search pointer. 
The forinat iss 

LINE 

The message Is 

FILE AT LINE NUMBER n. 

where n indicates the line of the edit file to which the 
search pointer is currently pointing. If n Is the last line 
of the file# the »«ords 

-END OF FILE- 

are Included In the message. 

3.2.5 LISTC COHMANO ILISTC OR LC) 

The LISTC cowffland prints a line of numbers so that the user 
can see what columns the data Is In. The format of the 
command Is: 

LISTC or LISTCn 

**here n is the number of columns to be listed (default Is 
791. The line appears as fotlOMS. 

123456789.123456789.123456789.123456789.123456789.123456789. 



3.2.6 EXAMPLE 

The following example illustrates the use of LIST* S£T# 
RESET* FIND* LINE and LISTC commands. 

edt#a 
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BEGIN TEXT EDITING. 
? list;* list to end of file 

PROGRAM RANONUM 
MAINSEED « 5**13 
NEXTSEED « 5**15 
HUNDRETH « I./IOO. 
BIGNOMBR « 2.**48 
FRACTION « HUNDRETH«BIGNUMBR 
IFRAC « IHTCFRACTION) 
DO 20 I « 1»10 
INCREMENT « 

NEXTSEED « NEXTSE£D*MAINSEED 
10 INCREMENT « INCREMENT^l 

IF C{INCR£MENT*IFRAC>. IT. NEXTSEED) GO TO 10 
NEWNUM ^ INCREMENT 
20 CONTINUE 
END 
-END OF FILE- 
? sets Advance search pointer 

forward eight lines from 
current setting. 
? i $iist line 

INCREMENT « 
? fine Determine position of search 

pointer relative to 
begi nn ing of file. 
FILE AT LINE NUMBER 9. 
? reset Reset search pointer to 

beginning, 
? I ist»znextseedz2 List first two occurrences 

of lines containing string 
/nextseed/. 
NEXTSEED « 5**15 
NEXTSEED =* NEXTSEEO*MAINS£ED 
? f i stsJnextseedll 3 List first three occurrences 

of string /nextseed/. 
NEXTSEED 

NEXTSEED NEXTSEED 
? findjS Advance search pointer and 

list tine. 
INCREMENT * 
? I/20/C/32 List lines containing first 

two occurrences of ellipsis 
string /20/c/. 
DO 20 I «1#10 
INCREMENT * 
20 CONTINUE 

? UstSf /20/»/c/2 List first two occurrences 

of ellipsis string /2D/*/c/ 
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3«2*6 EXAMPLE 



20 I « 1»10 
C 
20 C 
T findl- 

00 20 I * If 10 
? f Indf IhundrethI 
PHRASE NOT FOUND. 
? reset 
? f Indf Ihundrethl 



HUNDRETH = I./IOO. 
? fs/lffac/2 



IFRAC 
? Ifi 

FILE AT LINE NUMBER 
? S-5 



12. 



? Hst2 

IFRAC « INTCFRACTIONI 

DO 20 I « IflO 
? reset 
? fSf/13/#/15/ 



13 
NEXTSEED « 5**15 
? Ic30.f-1 

123456789.123456789.123456789 

PROGRAM RANONUM 
1 end 

END TEXT EDITING. 
REAOy. 



Move search pointer back one 
I ine and i 1st the i ine. 



Advance search pointer frofR 
current setting to line 
containing string 

/hundreth/. 

Advance search pointer to 
line containing second 
occurrence of string /Ifrac/ 
and i I st string. 



Move search pointer back 

f i ve i i nes* 

List tMO contiguous tines. 



Advance search pointer to 
line containing ellipsis 
/13/f /15/ and list line. 



List thirty columns^ backup 
one line and list the line. 



INSERTSf AD08 


and 


AODC 


coisniands cause new 


to be Included 


in 


the 


edit file at the place 


the user* 
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The ADO* 
information 
specified by 

3.3.1 ADO COMMAND 

An ADD operation requires two sets of information* the 
location where the text is added (supplied In the coiniiiand) and 
the actual new Infor^natlon to be Inserted In the edit file 
(supplied by the user In response to the ENTER TEXT request I* 

After the command Is entered* the system typess 

ENTER TEXT 

Respond to this request in one of four ways* 

1. Type the actual Information to be added (Including 
carriage returns and line numbers if requiredl* 
bracketed with delimiters* 

2* Type the dollar sign ($) character followed by a 
single space if you are an lAF user* since just the 
dollar sign could have a special meaning such as the 
cancel line character* All other users should type 
the dollar sign character with no delimiters or other 
characters* This causes the current contents of the 
string buffer to be added* (Information is placed In 
the string buffer by one or more EXTRACT 
statements* ) 

3* Type carriage return only* This causes the data 
entered in response to the most recent ENTER TEXT 



request to be added* 



mu 



(II yhenever a MERGE command Is 
issuedf the data entered In response t 
the most recent ENTER TEXT request Is 
lost* In this case* no data is added 
when the carriage return only Is 
entered in response to an ENTER TEXT 
request* 
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3.0 EDT CQMNANOS 
3.3,1 ADD COIiMAND 



iZ) If the ENTER TEXT request Is 
issued in a command buffert a carriage 
return Issued for the first request 
Mill cause all other ENTER TEXT 
requests to simulate a carriage 
return. This will happen until an 
input prompt Is issued ( a question 
mark)* 

4. T*io delimiters and a carriage return only* This will 
end the ENTER TEXT request and leave the edit file 
unaltered* 

Only single phrase search strings are allowed nith this 
command* Ellipsis string specifications are illegal* 

With no search string specification In force* the n 
parameter indicates where the insert! on shal I be made relative 
to the search pointer* 

3*3.1*1 LlQfi.Eailfi^EaLiais.iMO-fiE.Al 

AOO Inserts text after the line 

of the edit fUe specified 
by the search pointer* 

ADDin Inserts text after the nth 

line C counting forward from 
the search pointerl of the 
edit f I ie* 

ADD/string/ Inserts text after the line 

containing the specified 
string; search for string 
begins at current position 
of search pointer* 

AOOf /str ing/in Inserts text after each of 

the first n lines containing 
the specified string* 

daaiaad IiElioaiiaQ 

ADDS Same as ADD 
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3.3.1.2 String Hode Formats CAOOS or ASI 

ADOSn Same as ADDin* 

AODS#/str I ng/ Inserts text i tsiaedi ate! y 

f ol ioMing the specified 
string; search for string 
begins at current position 
of search pointer. 

ADDS5 Astr Ing/n Inserts text Inmedlateiy 

f ol loifing each of n 
occurrences of the specified 
str lng» 

Line inode ADD coinwands cause the addition of text follo*fing 
the end of a particular line# tihereas string mode ADD coaiifiands 
cause text to be added following a particular string of 
characters* A string iBode cowhand without a string 
specification is eguivalent to a tine mode command* 

3*3.2 INSERTS CQHHAHD (INSERTS OR ISI 

The INSERTS co«if»and is siwilar In purpose to the ADOS 
commandf except that the text to be inserted Is embedded 
within the comsiand^ thus speeding up the Interaction* 

The command has the following format* 

INSERTS/strlngl/str ing2/|n 

If the n parameter Is omitted* 1 Is assumed* 

The character string denoted by strlng2 Is inserted 
Immediately after each n occurrence of strlnglf beginning at 
the search pointer* Note that /str ingl/str Ing2/ specification 
Is not an elMpsis search string In this command* 

3*3.3 ADD BEFORE COHNANO CADOB OF AB) 

The ADDS command works Indentical to the ADD command except 
that the text is added before the line specified. It also 
works only In the line mode* 
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3.0 EOT CQHNANDS 

3«3«3«i ADDS tine mode fori^at 



ADD3 
ADD3n 



A008»/str Ing/ 



ADDB/strlng/n 



Inserts text before the line 
of the edit file specified 
by the search pointer* 

Inserts text before the nth 

line (counting forward from 

the search pointer) of the 
edit file. 

Inserts text before the line 
containing the specified 
string! search for the 
string begins at the current 
position of the search 
pointer. 

Inserts text before each of 
the first n lines containing 
the specified string* 



3.3.4 ADO COLUMN COHHA!»IO CAOOC OR AC) 

The ADOC command adds the string starting in the coluian 
specified. It «ioves all existing characters to the end of the 
string* and thus extends the line. The coswand format is. 

ADDC»/str lng/|/col/n 

If the n parameter Is not specified It Is assumed to be I. 

The contents of string are added to the first n lines. 



3.3.5 EXAMPLE 

The following example illustrates the use of the ADO* 
INSERTS and AOOC cofflwands. 



£ati:i£E&s&aiia£ 

edtffilel 

BEGIN TEXT EDITING. 
? add 



Caiefiaia£i 

EOT Is called* creating 
empty kiorking file •fllel*. 

The file Is built using the 
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3.0 EOT COMHANOS 
3«3«5 EXAMPLE 



ADD command* 
ENTER TEXT, 
? / the add command can be very 
? useful when creating a textual 
? file. / 

READY. 
? addsf^file. -i- Text Is added imniedi atet y 

after the first occurrence 
of string /file. /. 
ENTER TEXT. 
? /in fact* It Is one 
? of the few asethods that can be 
? used to build a direct access 
? file./ 

READY. 
? list* list to end of file. 

THE ADO COHMAND CAN BE 
USEFJL WHEN CREATING A TEXTUAL 
FILE. IN FACT, IT IS ONE 
OF ThIE FEW METHODS THAT CAN BE 
USED TO BUILD A DIRECT ACCESS 
FILE. 

-END OF FILE- 
? Inserts/access/perraanent/ The string /permanent/ is 

inserted after the first 
occurrence of the string 
/access/. 
? flnd4 

USED TO BUILD A DIRECT ACCESS PERHANENT 

? ass^flle* Text Is added directly after 

the first occurrence of the 
string /file/. 
ENTER TEXT. 
? t» providing It Is the edit filet 

READY. 
? a* Text is added to the end of 

file. 
ENTER TEXT. 
? « it Is also useful when adding 
? text to a previously existing file.* 

READY. 
? reset 
? 11=^ List the whole file. 3 

THE ADO COHMAND CAN BE VERY 
USEFUL WHEN CREATING A TEXTUAL 
FILE. IN FACT, IT IS ONE 
OF THE FEW METHODS THAT CAN BE 
USED TO BUILD A DIRECT ACCESS PERMANENT 
FILE, PROVIDING IT IS THE EDIT FILE. 
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IT IS ALSO USEFUL WHEN ADDING 
TEXT TO A PREVIOUSLY EXISTING FILE. 

-END OF FILE- 
? a/exIsting/ Add text after the line 

containing the string 
/existing/* 
ENTER TEXT. 
? /later it *«ill be demonstrated how to 
? use the add command to remove text 
? string buffer./ 

READY. 
? s8| Advance search pointer eight 

1 ines. 
? I ; 3 

LATER IT WILL BE DEHQNSTRATED HOW TO 
USE THE ADD COMMAND TO REMOVE TEXT 
FROM THE STRING BUFFER. 
? addo* ++1+ Add string / / to column 1 

of current line* 
? I 

LATER IT WILL BE DEMONSTRATED HOW TO 
? r 

? sfiedit files 
t adds Same as ADD coffltaand. 

ENTER TEXT. 
? I it Is especially useful when 
? adding text in the body of a file. i 

READY. 
? 13 List the next three lines. 

FILE* PROVIDING IT IS THE EDIT FILE. 

IT IS ESPECIALLY USEFUL WHEN 
ADDING TEXT IN THE BODY OF A FILE. 

? isitextual #># or source* Add string / or source/ 

directly after the first 
occurrence of string 
/textual/. 
PHRASE NOT FOUND. 
? reset. I SfXtextuaix or sourcex.li* 

THE ADD COMMAND CAN BE VERY 
USEFUL WHEN CREATING A TEXTUAL OR SOURCE 
FILE. IN FACT, IT ONE 
OF THE FEW METHODS THAT CAN BE 
USED TO SUILD A DIRECT ACCESS PERMANENT 
FILEf PROVIDING IT IS THE EDIT FILE. 

IT IS ESPECIALLY USEFUL WHEN 
ADDING TEXT IN THE BODY OF A FILE. 

IT IS ALSO USEFUL WHEN ADDING 
TEXT TO A PREVIOUSLY EXISTING FILE. 
LATER IT WILL BE DEMONSTRATED HOW TO 
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USE THE ADD COMMAND TO REMOVE TEXT 
FROM THE STRING BUFFER. 

'Bm OF FILE- 
? end 

END TEXT EDITING. 
READf. 
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3.4 a£aayiAL«Q£U!iEQEMiIIQti 

Four types of operation are available for rewoving 
Information from the edit file* DELETE* BLANK* OELETEC and 
delete end of line. 



3.4. 1 DELETE COMHAND 

A DELETE operation erases one or more occurrences of a 
particular string of characters or one or more lines 
containing a particular string of characters. The text is 
realigned* leaving no excess blanks* Al I operati ons begin at 
the current position of the search pointer. 

3.4.1.1 Liaa^Eaii£.£aLiats«iQ£L£I£«aE-Qi 
Caieand ££&iiiiaiifiQ 

DELETE Erases the line of the edit 

file specified by the search 
poi nter . 

OELETEn Erases the first n lines of 

the edit file beginning at 
the search pointer. 

DELETEf/str ing/ Erases the line containing 

the string* 

DELETES /str ing/n Erases the first n lines 

containing the string. 

DELETE/str ingl/#/str ing2/ Erases the first line or 

group of lines containing 
ell ipsis 
/str I ngl/#/strlng2/. 

DELETE*/stringl/stri ng2/ jn Erases the first n 

occurrences of the line or 
group of lines containing 
ellipsis /str Ingl/string2/. 

3.4.1.2 Stcia5-Eail£-£aLiiiLS.-ia£L£I£S-fiC-aSl 
CaiitQd £ji2iaQiiifiQ 

DELETES S awe as DELETE. 
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3«4*l»2 String Mode Formats IDEIETES or OS > 



DELETES; n Same as OELETEn* 

OELETES/str Ing/ Erases the specified 

stf ing« 

DELETES* /string/in Erases the first n 

occurrences of the specified 
string* 

D£LET£S/stringl/>/str ing2/ Erases the string of 

characters specified by the 
ellipsis 
/str ingl/>/str ing2/» 

DELETESs/stringl/str IngZ/jn Erases the first n 

occurrences of the string of 
characters specified by the 
ell ipsis /str Ingl/str lng2/« 



3*4.2 BLANK COMMAND 

The BLANK cowmand replaces the specified string* line or 
set of lines with blank characters. Unlike the DELETE* 
DELETEC and DEQL comwandsf BLANK does not relocate text* All 
operations begin at the current position of the search 
poi nter. 

BLANK Replaces with blanks the 

line of the edit file 

specified by the search 
pointer. 

BLANKn Replaces with blanks the 

first n lines of the edit 
file* beginning at the 
search pointer. 

BLANK#/str ing/ Replaces the line containing 

the string with blanks. 

BLANKS /str Ing/in Replaces with blanks the 

first n lines containing the 
string. 
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BLANK/stf lfigl/*/stri ng2/ Replaces with blanks the 

first line or group of lines 
containing ellipsis 

/stri ngl/*/string2/» 

BLANK/str Ingl/str ing2/n Replaces with blanks the 

first n occurrences of the 
line or group of lines 
containing el I I ps Is 

/stri ngl /stri ng2/« 

3.4 •2.2 itciaa-i2d£-£a£iaJts-iaL4Mlli-a£-asi 

BLANKS Sa»€ as BLANK. 

BLANKSin Same as BLANKn. 

BLANKS! /string/ Replaces «ith blanks the 

specified phrase* 

BLANKS* /str ing/in Replaces with blanks the 

first n occurrences of the 
spec! fled phrase* 

BLANKSf /str ingl/#/str ing2/ Replaces with blanks the 

string defined by the 
ell Ipsis 
/strlngl/f /string2/* 

BLANKS/str Ingl/str Ing2/;n Replaces with blanks the 

first n occurrences of the 
string defined by the 
ellipsis /strlngl/str ing2/* 



3.4.3 DELETE CQLUHN CQHMANO (OELETEC OR DC J 

The OELETEC cofBmand removes all InforfRation In the columns 
specified. Like the DELETE comsiand the edit file Is 
realigned. The column specification wust be presentm The 
columns indicated are Included in the deleted columns. Note> 
a seiai-colon cannot appear before the column specifier in this 
one coffiisand. The format of the command follows. 

D£LETEC//col/|n 
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If the n paraBieter Is not present* 1 Is assumed. 

The columns specified in the col specifier are deleted fros« 
the first n lines* The rest of the characters in these lines 



are packed together* 



3*4*4 DELETE END OF LINE (OEOL) 

The DEOL corawand will sierge lines together* The end of 
line teriRinator is removed and the next line is abuted next to 
the last non-blank character of the current line* The format 
of the command is as follows* 

OEOL In 

The first n Cby default 1) end of lines are deleted* This 
causes the first n^-l lines to become one line* If the new 
line Is laore than 150 characters sosie of the character may be 
lost through truncation of the line* 



3*4*5 EXAMPLE 

The folioiiing is an example of DELETE^ OELETEC* DEOL and 
BLANK commands* 

e d t > a 

BEGIN TEXT EDITING* 
? 1^ List to end of file* 

PROGRAM RAHONUM 

MAINSEED « 5**13 

NEXTSEED « 5**15 

HUNDRETH « 1*/100* 

BIGNUM8R * 2***48 

FRACTION « HUNDRETH*BIG 

IFRAC « INTCFRACTIQN) 

DO 20 I « If 10 

INCREMENT » 

NEXTSEED « NEXTSEED*MAINS£ED 
10 INCREMENT » INCREMENT+1 

IFCCINCREMENT*IFRACr .LT*NEXTSEEOI GO TO 10 

N£«NUH « INCREMENT 
20 CONTINUE 

END 
-END OF FILE- 
? delete#*bigNUMBRnumbr+* Delete every line In file 
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that contains the string 
/bi gnumbr/* 
2 OCCURRENCES Qf PHRASE FOUND. 
? S53 Advance search pointer three 

I ines. 
? 12 

HUNORETH « I./IOO. 
IFRAC * INT(FRACTIQN) 
? a 

ENTER TEXT. 
? / big « 2'«'*48 
t fraction a hun(Jreth*bl g/ 

READY. 
? bl anks> xhundrethx Blank first occurrence of 

string /hundreth/* 
? 1 12 

« I./IOO. 
BIS « 2.**48 
? ac»?hl00?|?7? Insert string /hlOO/ 

starting In column seven. 
? I 

HlOO « I./IOO. 

? ds/ / Delete eight spaces denoted 

by string / /. 
? I 

HlOO « I./IOO. 
? bl anks)undrethj. I ine Blank first occurrence of 

string /undreth/ and get 
current line number. 
FIIE AT LINE NUMBER 4. 
? f2 

FRACTION « H tBIG 
? adds/h/ 

ENTER TEXT. 
? /lOO/ 

READY. 
? IC31.I 
123456789. 123456789. 123456789.1 

FRACTION » HlOO *BIG 
f dc??22f29? Delete colu»ns 22 to 29, 

incluislve. 
I I 

FRACTION * H100*BIG 
? r.f|13 
20 CONTINUE 

? ds#/20/end/ Delete string specified by 

etiipsis /20/#/end/. NoteJ 
string deleted not line 
? II* 
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-END OF FILE- 
t acf/ pr int»fiewnyfii//6/ 



? 1. a 

PRINTfNEWNUH 
ENTER TEXT. 
? /20 cont 

? inue 
? end/ 

READY. 
? 14 

PRINTtNEyNUH 
20 CONT 
INUE 

END 
? s.deol 



? I 

20 CQNTIHyE 
? end 

END TEXT EDITING. 
READY. 



Add string starting in 
coiumn 6 (there Is no cofy^n 
seven). 



A carriage return 
pressed by mistake. 



was 



Advance search pointer one 
I Ine and remove the en4 of 
i ine 
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3*5 SUBSTITUTION OF INFORMATION 



3.5 SUaSLIIiyiia!i.0£«Ili£Q£I3AIiQM 

The CHANGEf CHANGECf CEOL and RS connnands each cause a 
specified set of text information to replace text already 
present in the edit file* The length of the new information 
is independent of the length of the replaced text. 



3.5a CHANGE CQHfiAND 

In effect* the CHANGE coiBiaand combines a DELETE operation 
and an ADO operation. A complete CHANGE operation requires 
two sets of information* a definition of the area to be 
changed (which is supplied in the CHANGE coinniand) and the 
infonsation that is to be inserted into that area (which is 
supplied by the user In response to the ENTER TEXT re<iuest). 

After the co^wand Is entered* the system typest 

ENTER TEXT, 
? 

Respond to this request In one of four ways* 

I* Type actual change inforfnation (including carriage 
return and line numbers* if reguiredl* bracketed with 
de i i !si ters* 

2* Type the dollar sign ($) character followed by a 
single space if you are an lAF user* since just the 
dollar sign could have a special meaning such as the 
cancel last character* Al I other users should type 
the dollar sign character with no delimiters or other 
characters. This causes the current contents of the 
string buffer to be used as the change information. 
(Information is placed in the string buffer by one or 
more EXTRACT statements. I 

3* Type carriage return only. This causes the data 
entered in response to the most recent ENTER TEXT 
request to be used as the change information. 

Whenever a HERGE command is Issued* 
the data entered In the most recent 
ENTER TEXT request is lost. In this 
case* no data is added if carriage 
return only is entered in response to 
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An ENTER TEXT re<|uest« 

^» Type two delimiters and a carriage return. This Is a 
do nothing Instruction and nil I terminate the ENTER 
TEXT request without altering the edit file. 

3.5.1.1 Uafi-aflii£.£a£ffiaU-liiaAM££-ai:.£l 

CHANGE Replace the line specified 

by the search pointer ultli 
the text that follows. 

CHANGEn Replace the first n lines of 

the edit file beginning at 
the search pointer with the 
text that follows. 

CHANGE/str ing/ Replace the line containing 

the string with the text. 
The search for the string 
starts at the current 
position of the search 
pointer. 

CHANGEs/str lng/;n Replaces the first n lines 

containing the string with 
the following text. 

CHANGE»/str Ingl^str i ng2/ Replaces the line or group 

of line containing ellipsis 
/stri ngl/string2/ with the 
following text* 

CHANGE/str ingl/f/strlng2/n Replace the first n 

occurrences of the lines 
containing the ellipsis 
/str ingl/# /str ing2/ with the 
following text. 

3. 5 a. 2 st£.iQii^aiijia.£atiit,KtlM££S-.a£«iISl ] 

Caiiaad £iEiaQaiitQ I 

CHANGES Saflie as CHANGE 

CHANGESn Same as CHANGEn* 
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CHANGES/string/ 



CHANGESf /strlng/in 



CHANG£$J/stringl/strlng2/ 



CHANGES / St rfngl/str I ng2/n 



Replace the specified string 
with the following text. 
The string search starts at 
the current search pointer. 

Replace the first n 
occurrences of the string 
with the following text* 

Replace the string of 
characters specified by the 
ell ipsis /str ingl/strlng2/ 
with the following text. 

Replaces the first n 
occurrences of the string of 
characters specified by the 
ellipsis /str ingl/stf ing2/ 
with the following text* 



3.5.2 RS CQMHAND 

The RS cowhand Is similar to the CHANGE cosaaiand except that 
It performs only string replacements and the replacement text 
Is embedded In the corowandf thus speeding the Interaction. 
Also* the structure of the RS command does not allow ellipsis 
string specifications. 

The format of the command is as follows. 

RS/stringl/str lng2/n 

The first n (by default 1) occurrences of stringl will be 
replaced with strlng2* 



3.5.3 CHANGEC CQHMANO (CHANGEC OR CCI 

The CHANGEC command will replace the indicated columns with 
the string. Unlike the CHANGE and RS commands* the CHANGEC 
command works on columns instead of fines. The columns will 
be changed Irregardless of the contents. The format of the 
command Is as follows. 

CHANG£C/strlng/|/col/|n 

The first n rby default II lines containing the columns 
indicated by •col* will be replaced with 'string*. 
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3.5,4 CEQL COf^HANO (CEOL) 

The CEOL coiamand is an easier way to replace the end o# 
line with a string plus an end of Hne# The string will be 
placed before the end of fine and Mill remove ail spaces 
between the end of line and the last character. In this one 
conniand the column and deliiiited string specifiers cannot be 
used. The format of the command is as follows. 

CEOL /string/ In 

In the first n Iby default 1) lines of the edit file the 
end of line will be replaced by the string plus and end of 
I ine. 



3.5.5 EXAMPLE 

The following is an example of CHANGE* 
commands. 



CHANGEC* CEQL and RS 



EQt£iZ&£s&aas£ 



CaaifiQtAti 



edt»a 

BEGIN 
? I* 



10 



20 



-END 
? chi 



ENTER 
? / 
READY 



TEXT EDITING. 

List to end of file. 
PROGRAM RANONUM 
MAINSEED « 5**13 
NEXTSEED » 5**15 
HlOO « I./IOO. 
BIG « 2.**48 
FRACTION « H100*8IG 
lERAC « INTIFRACTION) 
DO 20 I « 1»10 
INCREMENT « 

NEXTSEED « NEXTS£ED*MAINS£ED 
INCREMENT « INCREMENT*! 

IFCCINCREM£NT*IERAC) .LT. NEXTSEED) 60 TO 10 
N£«NUM « INCREMENT 
PRINTfNEWNUM 
CONTINUE 
END 

OF FILE- 
nge Change line indicated by 

current setting of search 

pointer. 
TEXT. 

program random loutputl/ 
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? rsSnextseedSfSnextsdS* Replace each occurrence of 

the string /nextseed/ with 
/nextsd/. 
4 OCCURRENCES OF PHRASE FOUND. 
? f2 

NEXTSD « 5**15 
? f|7 

NEXTSD « NEXTSD*MAINS£ED 
? cs/seed/ Change first occurrence of 

string /seed/ with string 
/sd/. 
ENTER TEXT. 
? ?sd? 
READY. 
? I 

NEXTSD » NEXTSO*MAINSD 
? /r/cs»#seedil5#/ f 53 Reset the search pointer* 

change ellipsis string 
/seed/15/ and list three 
I Ines. 
ENTER TEXT. 
? 8sd « 5**13 
? nextsd « 5**178 
READY. 

PROGRAM RANDOM lOUTPUT) 
MAINSD « 5**13 
NEXTSD = 5**17 
? rs#*i ncrement^f »lnc*5 Replace first five 

occurrences of string 
/Increment/ with /Inc/. 
? rs/fr act ion/>/fr ac/l 2 Replace two occurrences of 

/fraction/ with /frac/. 
? Is/inc/j5 
INC 

INC INC 
INC 

INC 
? change 

ENTER TEXT. 
t «c thus prograw generate 
7 c 10 randofi! nu«bers between 
? c 1 and 100. 
? prograai random (outputim 

READY. 
? Ic44.l 

123456789.123456789.123456789.123456789.1234 
C THUS PROGRAM GENERATE 

t cCf/i//9/ Change coluron nine to string 

/ i / 
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? 


ceol »/s/ 


Repi ace 








s tr 1 n q 








return. 


? 


f 






c 




THIS PROGRAH GENERATES 




? 


c/neKnuia/neKnufR/ 


Change 








ell ipsi 








/nennufii 


ENTER TEXT, 




? 


• 


nran « Inc 




? 




print 30 Iforan 




• 

Rl 


30 


format <i2*2xfi4} 




:ADY, 




? 


!♦ 






C 




THIS PROGRAM GENERATES 




c 




RANDOH NUMBERS BETWEEN 




c 




I ANO lOO, 

PROGRAM RANDOM lOUTPUT) 

MAINSD « 5**13 

NEXTSD * 5**17 

HlOO « I./IOO. 

BIG « 2. ♦♦^8 

FRAC « H100*SIG 

IFRAC « INT(FRAC) 

DO 20 I « IflO 

INC « 

NEXTSO » NEXTSD*MAINS0 




10 




IMC « INC+1 








IF CUNC*IFRACr. IT. NEXTSO 1 


GO TO 10 






NRAN « INC 








PRINT 30f If NRAN 




30 




FORMAT <I2#2XfI4) 




20 




CONTINUE 
END 




-END 


OF FliE- 




? 


end 




END - 


lEXT EDITING. 




READY 


• 





carriage return with 
/s/ and carriage 



i ineCs) containi ng 
s string 
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3,6 LOADING AND CLEARING THE STRING BUFFER 



3 . 6 LQ4QI!ia-i^Mi}.CLEiEIIiE-ia£-.HaiMS-ay££££ 

The string buffer Cdescribed in section 2) can be loaded 
nith the EXTRACT command* Information is transfered from the 
string buffer to the edit file with the ADD and CHANGE 
coaiffiands. The buffer Is not automatically cleared when 
Information Is transfered by either of these commands | it Is 
cleared only with the CLEAR command* The string buffer may 
also be kept as a local file when the edit session is finished 
with the LOCAL command* 



3*6*1 EXTRACT COHMAND 

The EXTRACT command appends a copy of Information from the 
edit file to the string buffer* This operation has no effect 
on the edit file* 

3*6.1*1 LiOfi.lSfidfi.Eatia t4.1£XIE4CI.aL-£i 

EXTRACT Copies one line beginning at 

the search pointer* 

EXTRACTln Copies n lines beginning at 

the search pointer* Clf n 
egual ** all lines to the 
end of file are copied*} 

EXTRACT/string/ Copies the first line 

containing the strlngi the 
search for the string starts 
at current position of the 
search pointer* 

EXTRACT/str ing/n Copies the first n lines 

containing the string* 

EXTRACT»/stringl/f /strlng2/ Copies the first line or 

group of lines containing 
the el I I PS Is 

/stringl/»/string2/* 

EXTRACT/stringl/strl ng2/n Copies the first n 

occurrences of the line or 
group of lines containing 
the el f psi s 

/strlngi /string 2/* 
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3*6«I«E String Mode Formats CESI 



ES Same as EXTRACT. 

ESn Same as EXTRACTn. 

ES/string/ Copies the string specifledl 

search for string hegins at 
current position of the 
search pointer. 

ES>/str lng/|n Copies the nth occurrence of 

the string. 

ESs/stringl/j/str ing2/ Copies the string of 

characters specified by the 
ei f I PS is 
/ st ring! /* /string 2/. 

ES/str lngl/string2/n Copies the nth occurrence of 

characters specified by the 
ellpsis /str ingl/str ing2/» 

3.6.2 CLEAR COMMAND (CLEAR OR CD 

The CLEAR cowmand clears the string buffer. It is the 
user's responsibility to clear this buffer and if he fails to 
do so> Inforsiatlon from subse^iuent EXTRACT operations is 
appended to the Information froa previous EXTRACT operations* 
The format IsJ 

CLEAR 

Operand fields are never used with this cowBiand. 

3.6.3 LOCAL COMMAND UOCALI 

The LOCAL coMsand causes the string buffer to reaain as a 
local file when the edit session Is ended. Thus a section of 
the edit file Biay be extracted and kept local. Only the 
information in the string buffer at the end of the edit 
session Mill be kept. A MERGE cofmaand removes all previous 
Information froffl the string buffer. The forwat of the command 
iss 
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LOCAL/ I fn/ 

The string buffer wi i I be a focal file called I f n at the 
end of the edit session. Notet the last LOCAL co^wand {if 
used more than once) will contain the Ifn* 

If the string buffer has not been used the command lilll be 
ignored and the following message Issued* 

STRING BUFFER HAS NOT SEEN USED. 

If there Is a problem in making the file locals the command 
Mill not be completed and the fotloning message hIII be 
i ssued. 

LOCAL FILE ERROR. 

If the file name specified is a reserved or Invalid file 
name* then the command will be ignored and the folloiiing 
message issued. 

RESERVED FILE NAME, 



3.6.4 EXAMPLE 

The following example Illustrates the use of EXTRACT* CLEAR 
and LOCAL commands. 

edt»a 

BEGIN TEXT EDITING. 
? list* 

THE EXTRACT COMMAND CAN BE 
VERY USEFUL IN REARRANGING 
LINES OF TEXT. 
-END OF FILE- 
I s2*extract The third line Is copied 

into the string buffer. 
t r.a.ll* The contents of the string 

biffer are inserted into the 
file. 
ENTER TEXT. 
? $ 
RE AOY 

THE EXTRACT COMMAND CAN BE 
LINES OF TEXT. 
VERY USEFUL IN REARRANGING 
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tlHES OF TEXT. 

-END OF FILE- 
? s/t ines/2«d«f Delete line containing 

second occurrenc of 
/ II nes/« 
? a 

ENTER TEXT. 
? )used to restructure Individual) 

READY. 
? es/rearr anglng/.a*. I ;♦ Copy string /rearranging to 

string buffer. 

ENTER TEXT. 
? $ 

READY. 

THE EXTRACT COMMAND CAN BE 
USED TO RESTRUCTURE INDIVIDUAL 
LNES OF TEXT. 

VERY USEFUL IN REARRANGING 
LINES OF TEXT. 
REARRANGING 

-END OF FILE- 
? clear Clear string buffer. 

t slveryl.d* 

-END OF FILE- 
? es/restructure/ 

-END OF FILE- 
? r.es%restructure% 
? csyklndl vl dualk. I i^t" 

ENTER TEXT. 
? $ 

READY. 

THE EXTRACT COMMAND CAN BE 
USED TO RESTRUCTURE RESTRUCTURE 
LINES OF TEXT. 

-END OF FILE- 
? dslrestructure/.a* 

ENTER TEXT. 
? C refflewber that the string 
? buffer is not cleared after an 
? add or change $ cofflffland. 
? to remove text froi« the string 
t buffer* use the clear comffiand.i 

READY. 
? clear Clear string buffer* 

? es# strl ngibuf ferf i 

t ds# str ingibuf feri Note difference between 

these two ellipsis strings. 
? ass<that the<.l* 

ENTER TEXT. 
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? $ 

REAOY. 

THE EXTRACT COMMAND CAN BE 
USED TO RESTRUCTURE 
LINES OF TEXT. 

REMEMBER THAT THE STRING 
BUFFER IS nor CLEARED AFTER AN 
ADO OR CHANGE $ COMMAND. 

TO REMOVE TEXT FROM THE STRING 
BUFFER* 

IS NOT CLEARED AFTER AN 
ADO OR CHANGE $ COMMAND. 

TO REMOVE TEXT FROM THE STRING 
BUFFER* USE THE CLEAR COMMAND. 

-END OF FILE- 
? cl.d#zb«f f er#2»ze strlngz.l* 

THE EXTRACT COMMAND CAN BE 
USED TO RESTRUCTURE 
LINES OF TEXT. 

REMEMBER THAT THE STRING 
BUFFER IS NOT CLEARED AFTER AN 
ADO OR CHANGE $ COMMAND. 

TO REMOVE TEXT FROM THE STRING 
BUFFER* USE THE CLEAR COMMAND. 
-END OF FILE- 
e3. local /abed/. end 
END TEXT EDITING. 
READY. 
I nh* abed 

THE EXTRACT COMMAND CAN BE 
USED TO RESTRUCTURE 
LINES OF TEXT. 
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3 . 7 £QII.£iL£-aii!£!^iIQtiIliS-CQt!£l&fciDi 

The LENGTH* COLUMN and WIDTH commands are used to 
re-specify the dinsensions of the edit file. The ALIGN coewand 
removes extraneous blanks for printing purposes* 



3.7.1 LENGTH COMMAND CLENGTH) 

The LENGTH command will shorten a fife. This mIH have the 
effect of simulating to the editor that the file was never 
longer than the new shortened file* Thus the area of the file 
outside the truncated part cannot be affected by any co^wand 
except for the LENGTH coiamand. In a large file where only a 
sfliati portion of the file is to be edited* this command will 
also speed up the Interaction. The file can be shortened from 
both ends of the file. The forroat of the cowhand Iss 

LENGTHS /I ine/ 

The file will be shortened If line is specified and 
restored to Its full length If line Is absent. The string 
line has the saroe format as the col specifier. The search 
pointer is placed at the first line of the shortened file and 
at the current line when the file is restored. 

If •line» equals /5>10/ * then the lines five through ten 
will be the only lines In the edit file. 

If the file has been truncated and a second truncation Is 
attempted Cbefore the file has been restored)* the comraand is 
ignored and the fol towl ng message is issued. 

FILE ALREADY TRUNCATED. 

If the file has not been truncated Cor has been restored! 
and a restore is attewpted* the command Is ignored and the 
following nessage issued. 

FILE NOT TRUNCATED. 

If the edit session is terminated by the END coaiaand and 
the file is truncated* the following message is Issued before 
the END occurs. 

WARNINGS FILE HAS BEEN TRUNCATED. 
DO YOU WANT TO END ? 

If the session I s to be ended with a shortened file enter 
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YES Cor y)f otherwise enter NO Cor N) and the END cowmand Is 
I gnored* 

liOI£ 

IF the editor Is aborted with the 
ABORT or STOP cowraandf the shortened 
file will remain shortened* The part 
of the file which preceeds the^! 
truncated file Is In the file SCR3. 
The trailing en4 of the edit file ii 
in the file SCR6. 

If the file is not long enough for the truncation the 
folfowlng message will be issued and the command ignored* 

FILE NOT LONG ENOUGH* 



3.7*2 WIDTH COMMAND (WIDTH OR y) 

The yiDTH cowwand defines the waxiaimii number of character 
columns that can be contained In a single line of the edit 
file when used with the ALIGN command* The command has ^no 
effect unless followed by an ALIGN command* The format Iss, 

yiOTHin 

where n is the new line length» and 6 »< n «< 150. Note# 
however^ that If n is larger than the size of the carriage* 
over-print may result on the right-hand end of a printed 
I Ine* 

Following a yiOTH command* the ALIGN command can be used to 
remove superfluous blanks and reformat In accordance with the 
changed right margin. 



3.7.3 ALIGN COMMAND (ALIGN OR AD 

The ALIGN command eliminates extraneous blanks from the 
edit file* while retaining the structural integrity of words* 
sentences and paragraphs. 

A word is defined as a set of characters between spaces* A 
sentence is defined as a group of words ending with a period 
Cor question mark). The beginning of a paragraph Is defined 
by an indented sentence. 
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The ALIGN cowfliaRd indents five spaces at the beginning of 

each paragraphs separates each word with one blanks and 
separates each sentence <group of Mords ending with a period 

or question fnarkl with tifo blanks* Blank lines are not 

removed as It Is assumed that they serve a purpose In 
delimiting paragraphs and lines. 

The following forms are valid forms of this command. 



ALIGN 



ALIGNn 



ALIGN/string/ 



ALIGN* /string/ in 



ALIGNs/strlngl/strlng2/ 



ALIGN/$tringl/>/strlng2/|n 



Removes excess blanks 
between words In the line of 
text specified by the search 
pointer. 

Removes excess blanks 
between words In n lines of 
text beginning at the search 
pointer. As many complete 
words as possible are placed 
in a line before starting 
another I Ine* 

Removes blanks from the line 
of text containing the 
specified strlngi search for 
the string begins at current 
position of the search 
pointer • 

Removes blanks from the 
first n lines containing the 
sped f I ed string. 

Removes blanks from the 
lines of text specified by 
ell Ipsis /strl«gl/str Ing2/ 

Removes blanks from the 
first n occurrences of the 
line <ir group of lines 
specified by ellipsis 
/str Ingl/f /str lng2/. 
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3.?,4 COLUMN COMMAND (COLUMN OR COLI 

The COLUMN comm^mi chanses the default column limits* 
Whenever a command using strings is executed the default 
coiunn limits are used unless the coluoin limits are specified 
on the command. The default limits are 1 to 150. If the 
starting column is greater than the ending 

column or a column is greater than 150 then a syntax error 
Mill occur* The command format is: 

CQLUMN/col/ 

The columns specified hy col (same format as the column 
specifier! will become the default column limits* 



3.7.5 EXAMPLE 

The following section illustrates the use of LENGTH* WIDTH* 
ALIGM and COL commands. 



e d t » a a 

BEGIN TEXT EDITING. 
? I* 

THE LENGTH COMMAND IS VERY 
USEFUL WHEN IT IS DESIRABLE TO 
WORK ON ONLY A SMALL r>ORTION 
OF A LARGE FILE. 

THE WIDTH COMMAND IS 
EFFECTIVE ONLY IF FOLLOWED BY AN 
ALIGN COMMAND. 
-END OF FILE- 
? Iength/lf4/ Truncate edit file to 

Include lines one to four* 
? Midth;20 Set width indicator to 20. 

? II* 

THE LENGTH COMMAND IS VERY 
USEFUL WHEN IT IS DESIRABLE TO 
WORK ON ONLY A SMALL PORTION 
OF A LARGE FILE. 

-END OF FILE- 
? length Restore truncated file. 

? s%. align* Move the search pointer 

forward four lines and align 
to end of file with width of 
20. 
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? r.l* 

THE LENGTH COMMAND IS VERY 
USEFUL WHEN IT IS DESIRABLE TO 
WORK ON ONLY A SMALL PORTION 
OF A LARGE FILE. 

THE WIDTH 
COMMAND IS EFFECTIVE 
ONLY IF FOLLOWED 8Y 
AN ALIGN COMMAND. 

-END OF FILE- 
? align. 14 Align line specified by 

search pointer. 
THE LENGTH 
COMMAND IS VERY 

USEFUL WHEN IT IS DESIRABLE TO 
WORK ON ONLY A SMALL PORTION 

? al »/ver y/work/. I ♦ Align lines containing 

ellipsis string 

/very/work/. 
THE LENGTH 
COMMAND IS VERY 
USEFUL WHEN IT IS 
DESIRABLE TO WORK ON 
ONLY A SMALL 
PORTION 
OF A LARGE FILE. 

THE WIDTH 
COMMAND IS EFFECTIVE 
ONLY IF FOLLOWED BY 
AN ALIGN COMMAND. 

-END OF FILE- 
? H|62.al*.i* Set width to 62 and align 

entire file. 
THE LENGTH COMMAND IS VERY USEFUL WHEN IT IS DESIRABLE TO 
WORK ON ONLY A SMALL PORTION OF A LARGE FILE. 

THE WIDTH COMMAND IS EFFECTIVE ONLY IF FOLLOWED BY AH 
ALIGN COMMAND. 
-END OF FILE- 
? col/>40/ Set coluiRn search to colymns 

1 to 40. 
t l/desir able/ Search for string 

/desirable/. It is not 
found because it is not 
contained In columns 1 to 
40. 



IS VERY USEFUL WHEN IT IS DESIRABLE TO 



? 


PHRASE NOT FOUND. 


7 


col/30f70/ 


? 


Udesirable] 




THE LENGTH COMMAND 
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? btanks/Mork on/ 
? *iidth32.al5*.l« 

THE LENGTH COMMAND IS VERY 
USEFUL WHEN IT IS DESIRABLE TO 

ONLY A SMALL PORTION OF A 
LARGE FILE. 

THE WIDTH COMMAND IS 
EFFECTIVE ONLY IF FOLLOWED BY 
AN ALIGN COMMAND. 

-END OF FILE- 
? end 

END TEXT EDITING. 
READY. 
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3.8 UaUUIIQli.£Qd£3A!iQ^ 

The com«ands OEFTAB* TAB and IISTAB allow the user to 
create structured text using tab settings* 



3,8.1 OEFTAB COMMAND <DEFTAB OR DT) 

The OEFTAB cowaiand defines a single tab character that is 
used (when responding to an ENTER TEXT request) to cause blank 
fill to the next tab stop* The tab character must not be 
present In the body of text that Is to be created* Each 
typing of the tab character that occurs when entering text Is 
Ignored* except for purposes of tab control* 

The follotiing are valid forms of the command* 

DEFTA3 clears previous tab 

character definition* 

DEFTAB/tabchar/ Defines the character 

tabchar as a tab character* 



3*8*2 TAB COMMAND (TAB OR T) 

The TAB command sets tab stops at specified input columns* 
Default column numbers are 11* 18* 30* 40* 50* 

The following forms of the coamand are valid* 

TAB Clears existing tab stops* 

TA8*/tl* t2**«** tn/ Each tl is a column number* 

tl>0* A maximun of seven 
tab column numbers may be 
specified* 

TAB/name/ The tab character and tab 

column numbers associated 
with the name In the 
following list are set* 
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Tab Tab Stops 



CHPS 


11 


13 


30 


40 




ALGOL 


7 


10 


13 


16 


19 


FTN 


7 










SWt 


3 


5 


7 


9 


11 


COBOL 


8 


12 


16 


20 


24 


CliPS86 


10 


20 


41 


50 


60 


HETA 


10 


20 


50 







13 15 



The default tab character is •;• for all naises except 
ALGOL'S «$« and SWL's «?«. 

Only one TAB cofflwand can be active at one time. Entering a 
TAB comflsand negates the effect of any prior TAB comroand. 

Since tabulation specification applies to Input text* it 
Must be made before the text Is entered. 



3.8.3 LISTAB COHMANO (LISTAB OR LT) 

The LISTAB command causes a listing of the tab stops as 
specified In the roost recent TAB coaiiRtnd. The cofRwand format 
is: 

LISTAB 

The systeai responds? 

TAB c STOPS tl*t2»...»tn 

where c is the tab character and tn are the tab columns. If 
the tab has been cleared (refer to TAB co«jBand)» the systew 
responds? 

TAB : STOPS NONE. 

3.8.4 EXAHPLE 

The following example Illustrates the use of TAB* DEFTAB* 
and LISTAB cosinands. 

edt»a. 



EOT - EXTENDED VERSION OF NQS EDIT 
3.0 EOT COMMANDS 

BEGIN TEXT EDITING. 
? add 

ENTER TEXT. 
? / the deftab and tab coiRwands 
t are effective only if given prior 
? to an enter text request, thus 
? the foMoHlng will not be tabulated. 
? 1#2#3#4 
? 5#6#7#8 

? now define a tab character 
? and a set of tab stops./ 

READY. 
? deftabs/#/ Define the character # as 

the tab 
? tab»/5>10»20/ character *iith stops at 



5>10> and 20. 



t add* 

ENTER TEXT. 
1 /a#b#c#d 
? e#f#9#h/ 

READY. 
? list* 

THE DEFTAB AND TAB COMMANDS 
ARE EFFECTIVE ONLY IF GIVEN PRIOR 
TO AN ENTER TEXT REQUEST. THUS» 
THE FOLLOWING WILL NOT BE TABULATED. 
1#2#3#4 
5#6#7#8 

NOW DEFINE A TAB CHARACTER 
AND A SET OF TAB STOPS. 
ABC 

E F G H 

-END OF FILE- 
? listab 

TAB # STOPS 5 10 20 
? deftab 
? tab 
? It 

TAB s STOPS NONE. 
? tab/cmps/ 
? It 

TAB i STOPS 11 18 30 40 
? end 

END TEXT EDITING. 
READY. 
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3.9 £n£a^4k-£IL£.CQI3l34MaS 

There are three file commands which will allow the user to 
stay in the editor and switch edit files. These cowwands are 
the MERGE* REPLACE and SAVE comwands. The comniand MERGEL is a 
helper comwand for MERGE. 



3.9.1 MERGEL COMMAND CMERGEL OR ML I 

The MERGEL command is used to specify which lines of the 
merge file are to be added to the file. The command does not 
merge the files* It only sets up the parameters for the MERGE 
command. This command will do nothing unless It is followed 
by a MERGE command. By default the whole file will be 
merged. The format for the command iss 

MERGEL/string/ 

The string Is structured In the same format as the column 
specifier* except that Is applies to lines. 



3.9.2 MERGE COMMAND (MERGE OR M) 

The MERGE command causes the contents of a specified file 
(working or permanent) to be merged Into the edit file. The 
following formats of the command are valid. 

MERGE/fl!e/|n or MERGE* /f I le/f /str I ng/|n 

The file referenced Cby the *flle« string) can be a local 
file or a permanent file* but it cannot be the current edit 
file or any other reserved file name (refer to appendix Al. 
The merge file is placed after the nth (by default n » 1) line 
or after the nth line containing the 'string*. 

liaiE 

Whenever a MERGE command Is Issued* 
the data entered In reponse to the 
most recent ENTER TEXT request Is 
lost. Therefore* a carriage return 
only In response to an ENTER TEXT 
request causes no data to be added 
(refer to the ADD and CHANGE 
command) . 
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3.9.3 REPLACE COMMAND (REPLACE) 

The REPLACE coniwand wlH replace the ecHt file In the 

persianent file catalog of the current usemasie* This coiaiwand 

is the same as a REPLACE control card. The forisat of the 
command Is: 

REPLACE/pfn/ 

The edit file will be replaced in the permanent file 
catalog with the file name 'pfn*. If 'pfn' is not used* the 
edit file name will be used. 

If the edit file is a direct file the command is aborted 
and the following message Is issued. 



ATTEMPTED REPLACE ON DIRECT FILE. 

If the edit file is too big for an indirect file the 
following message Is issued and the file is not replaced. 

FILE TOO BIG. 

Any other error encountered in replacing a file will abort 
the command and issue the following message. 

PERMANENT FILE ERROR. 



3.9.4 SAVE COMMAND (SAVE) 

The SAVE command will save the edit file in the permanent 
file catalog of the current username. This command Is 
identical to the SAVE control card. The format of the command 
i s as f ol I ows. 

SAVE/pfn/ 

The edit file is saved with the file name 'pfn*. If 'pfn* 
is not present then the edit file name is used. The file is 
saved in the default manner of the SAVE control card. 

If a file of the same name exists^ the command Is aborted 
and the following message Is generated. 

FILE ALREADY PERMANENT. 

If the file is too big for an indirect fi le the following 
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message is generated* 

FILE TOO BIG* 

Any other error condition will abort the cofRiand and 
generate the follOMing message* 

PERMANENT FILE ERROR. 



3.9*5 EXAMPLE 

The following Htustrates the use of the MERSE* SAVE and 
REPLACE commands. 

Inh#f«txt2 Before entering £0T# 

time-sharing commands are 
used to list norklng fie 
txt2f Hhlch Is a copy of a 
permanent f I le* 

THIS FILE IS NAMED TXT2 

AND IS A COPY OF AN PERMANENT 

FILE OF THE SAME NAME. 

REAOf. 

neM>a. forking primary file a 

created* releasing working 
file txt2. 

READY. 

edt*a Enter text editor with empty 

primary file a as the edit 
file 
BEGIN TEXT EDITING. 

? add 
ENTER TEXT. 

? / this f i le is being bul It 

? using the text editor add 

? command./ 
READY. 

? II* 

THIS FILE IS BEING BUILT 

USING THE TEXT EDITOR ADD 

COMMAND. 
-END OF FILE- 

? merge/txt2/ Merge permanent file txt2 to 



end of edit file. 



? II* 

THIS FILE IS BEING BUILT 
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mXH THE TEXT EDITOR ADD 
COMMAND. 

THIS EliE IS NAMED TXTE 
AND IS A COPY OF PERMANENT 
FILE OF THE SAME NAME. 

-END OF FILE- 
t mergef /txtZ/permanent/ Merge permanent file txt2 

after first occurrence of 
string /permanent/. 
? i^ 

THIS FILE IS BEING BUILT 
USING THE TEXT EDITOR ADD 
COMMAND. 

THIS FILE IS NAMED TXT2 
AND IS A COPY OF A PERMANENT 

THIS FILE IS NAMED TXT2 
AND IS A COPY OF A PERMANENT 
FILE OF THE SAME NAME. 
FILE OF THE SAME NAME. 

-END OF FILE- 
? f!il/2»3/ The next MERGE command will 

only add the second and 
third lines of the iserge 
file. 
? Wf /txt2/*.l* 

THIS FILE IS BEING BUILT 
USING THE TEXT EDITOR ADD 
COMMAND. 

THIS FILE IS NAMED TXT2 
AND IS A COPY OF A PERMANENT 

THIS FILE IS NAMED TXT2 
AND IS A COPY OF A PERMANENT 
FILE OF THE SAME NAME. 
FILE OF THE SAME NAME. 
AND IS A COPY OF AN PERMANENT 
FILE OF THE SAME NAME. 

-END OF FILE- 
? save/abc/ 
? replace/abc/ 
1 end 

END TEXT EDITING. 
READY. 



EDT - EXTENDED VERSION OF NOS EDIT 



3-4? 
06 AUG 80 



3.0 EDT COMMANDS 
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3.10 5ISI!^a.IiJJlIQ£tiaE-aQU!ilIIiifi 



3.10.1 NUMBER COMMAND 

The NUMBER command provides a count of lines In a file or a 
count dependent on the presence of a specified string of 
characters* The count always begins relative to the search 
poi nter. 



NUMBER 
NUMBERr/string/ 



NUMBER* / str i ngl/ str I ng2/ 



Returns a line count frosi 
current search pointer value 
to end-of-flle. 

Returns a count of the 

number of lines In the edit 

file that contain the 
string* 

Returns a count of the 
nu(Bber lines that each 
contain the ellipsis 
/strlngl/string2/* 



3.10.1*2 S t£iaii-.f!ail£-£aLiiiS-iMy ilB£E5-a t-MSi 



Caiiaad 

NUMBERS 
NUMBERS* /string/ 

NUMBERS / St r i ngl /f /str I ng2/ 



Ei&aiaciJiiaQ 

Same as NUMBER 

Returns a count of the 
nuwfeer of occurrences of 
•string* In the edit file* 

Returns a count of the 
nufiber of occurrences of the 
e 1 1 p I s I s 
/stringl/#/string2/* 
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3.10.2 EXAMPLE 

The foHoning itiustrates the use of the NUMBER command* 

edt#a 

BEGIN TEXT EDITING. 
1 I* 



* 




THIS PROGRAM GENERATES 


* 




10 RANDOM NUMBERS BETWEEN 


* 




1 AND 100, 

PROGRAM RANDOM (QUTPUTO 

MAINSD « 5**13 

NEXTSD « 5**17 

HlOO * I./IOO. 

BIG » 2.**48 

FRAC « H100*8IG 

00 20 I » 1*10 

INC ' 

NEXTSD « NEXTSD*MAINSD 


10 




INC « INC* 

IF (CINC*FRAC).LT. NEXTSD) GO TO 10 

NRAN « INC 

PRINT 30» I» NRAN 


30 




F0RHATCI2f2X,I4) 


20 




CONTINUE 
END 


-END 


OF FILE- 


7 


mifflber Reques 



line count from 
search pointer to end of 
file. 
20 LINE TO EOF. 
t nujiiber/nextsd/ Request count of number of 

lines containing string 
/ ne X t s d / * 

3 OCCURRENCES OF PHRASE FOUND. 

t nuwbers/nextsd/ Request count of number of 

occurrences of string 
/nextsd/. 

4 OCCURRENCES OF PHRASE FOUND. 
? slO 

? n Request line count from 

search pointer to end of 
file. 
10 LINES TO EOF. 

? n/inc/*/0/ Request line count of number 

of lines containing eilpsis 
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/inc/»/0/ 

3 OCCURRENCES OF PHRASES FOUND. 
? end 

END TEXT EDITING. 
READY. 
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3.11 £aaM&MQ^ay£££as 

Command buffers are a means of executing a command or a 

series of commands a number of times without re-entering the 

commands* This is useful* for example* when proof reading a 

text file. The commandss 

S15.L15 

can be executed many times to read the file and stop to allow 
the user to read the current fifteen lines* 

EOT has two types of command buffers. It has Implicit and 
explicit command buffers. The implicit buffer cannot be 
executed more than once at a time* while the explicit buffer 
can be executed many times at once. 

There Is a restriction using these buffers. If an explicit 
command buffer Is executed within an explicit command buffer* 
the rest of the first command buffer is lost and the editor 
will go Into an Infinite loop. A program interrupt will stop 
the execution of the buffer. An Implicit command buffer 
cannot be called within an explicit command buffer. If 9T\ 
explicit command buffer is executed within an Implicit command 
buffer Cor within a line of input)* the rest of the Implicit 
buffer (or input) is executed after the command buffer Cunless 
It Is Interrupted). 



3.11.1 IMPLICIT COMMAND BUFFER 

The implicit command buffer Is defined as the last line of 
input read and executed by EOT* This command buffer can be 
executed by entering a global terminator and a carriage 
return. The buffer will be executed once for every time a 
terminator and carriage return Is entered. 



3,11.2 EXPLICIT COMMAND BUFFERS 

Explicit command buffers are those that are set up by the 
CBd commands and executed by the EXd commands Id equals A* B* 
or O* There are three buffers <A* 8* and C). Caution must 
be used In specifying the correct 'd* with the CBd and EXd 
command* otherwise the wrong buffer may be executed. 
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3.11.2.1 QaLit-caaiiAtiQ-icaA-at.caa^flt^caaji 

This command Hill save one of the three comjaand buffers 
(depending on •d*) until the buffer is overwritten. A second 
call to any buffer will ovenirlte It. The command has the 
f ol lowing format. 

Caiidod £jLfiiaQil;l2Q 

C8A or CBB or C8C Display the contents of the 

cofimiand buffer* 

CBd/string/ Place the contents of 

•string* into the cororaand 
buffer. 

The command buffer is limited to 150 characters Ctn normal 
mode). If more than this limit Is entered the command buffer 
will not be saved and the following message will be issued. 

COMMAND BUFFER TOO LONG. 

•string* must be legal EOT commands. 
Any delimiters used for commands 
within «strlng« cannot be the same 
delimiters that •string* has 
surrounding it. The first character 
of 'string* cannot be a local command 
terminator. It must use the current 
local terminator. 

3.11.2.2 Iiii.£0EI3ADiQ.i£iiA-a£.Ua^a£^£lCl 

The EXd command will execute the command buffer. The 
format of the command is as follows. 

EXAin or EXBin or EXCin 

The command buffer desired will be executed n Cby default 
one) times. 

If the CBd command has not been used for buffer *d» and the 
EXd command is issued the command will be aborted and the 
following message wl I i be issued. 

COMMAND BUFFER EMPTY. 
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3,11,3 EXAMPLE 

The fonowing exaiiiple illustrates the use of the 
command buffert CBn and EXn commands* 



implicit 



edtfaaa 

BEGIN TEXT EDITING. 
? 14. s4 

THE COMMAND BUFFER 
WILL STQRTEN THE NUMBER OF 
ENTRIES THAT THE USER NEEDS 
TO MAKE. 
? . 



ABC ABC 

ABC ABC 
ABC ABC ABC 
ABC ABC 
-END OF FILE- 
? s-4 
? cba/rs?abc?def ?.s/ 

t cba 

RS?ABC?OEFt.S 
f exa.t^*' 

ABC ABC 
ABC ABC ABC 
ABC ABC 
-END OF FILE- 
? ex a 3 

-END OF FILE- 
? s-4.1* 
DEF ABC 

OEF ABC 
DEF ABC ABC 

DEF ABC 

-END OF FILE- 
? end 

END TEXT EDITING. 
READY. 



CaSifiQitO 



The terminator mHI repeat 
the last input line 
CI4.S4}. 



Place string /r s?abc?def ?.s/ 
in command buffer a. 
List contents of command 
buffer a. 

Execute command buffer a 
once and list the file. 



Execute command 
three times. 



buffer 
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3.12 .aUCELUMQyS.CiJSaAMQS 



3.12*1 BREAK COMMAND (BREAK) 

TNe default mode of EDT is to allow the editor to process 
program Interrupts. Thus* the user cannot abort the editor 
with an interrupt. The break command allows the user to 
change the mode. The command format Iss 

BREAKf /mode/ 

where 'mode' can be ON (allows Interrupts to abort the editor I 
or OFF (allows the editor to process interrupts). 



3.12.2 ECHO COMMAND (ECHO) 

The ECHO command allows the user to print out the commands 
that EDT Is executing as It starts to execute them. This is 
useful when an alternate Input file Is used or in a batch mode 
edit. The command format iss 

ECHO/mode/ 

where •mode' Is ON (print the commands) or OFF (do not print 
the commands). 



3.12.3 ASCII COMMAND (ASCII) 

The ASCII command changes the character mode from the 
present mode to ASCII mode. This will allow upper and lower 
case characters to be used. The character mode Is returned to 
the initial mode when EDT Is finished. The command format Is? 



ASCII 



MQIE 
If commands follow the ascli command 
on the same line the following three 
characters must not appear in the line 
(because of a change In the display 
code in ascii mode). The characters 
are •?•* «*• and «3« signs. 
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3,12,4 NORMAL COMMAND (NORMAL) 

The NORMAL command changes the character a?ode from the 
present mode to NORMAL mode* This viltl at ion only upper case 
character to be used. The character mode Is returned to the 
initlat pode Mhen EOT is finished* The command format is as 
fol ioiis* 

NORMAL 

If there are commands following a 
NORMAL commandf these commands will 
not be Interpetafoie because they are 
in ASCII mode. This applies to the 
command buffers as well as commands 
strung together on the input line. 
The NORMAL command must be the last 
command before EOT requests input. 



3.12.5 TERM COMMAND (TERM) 

The TERM command redefines the global command terminator 
(by default a period). The is used by the implicit command 
buffer as well as the default terminator. The command format 

i S 5 

TERM/char/ 
nhere 'char* is the new global terminator. 

3.12.6 EXAMPLE 

The following example illustrates the ASCII* BREAKf ECHO* 
NORMAL and TERM commands. 

edt^aaa 

BEGIN TEXT EDITING. 
? echo* /on/ turn on the command echo. 

t U* 
LI* 

THESE COMMANDS DO NOT 
AFFECT THE EDIT FILE* BUT 
THEY TO ASSIST THE USER IN 
USING EOT. 
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1 tjreakJoffl.lj* 



BREAKIOFFl 
LI* 



Turn off 
Interruption 
dief auit) • 



program 
Cthis Is 



THESE COMMANDS 



<— - the break key is pressed^ 



? echo/of f /.break/on/ 

ECHO/OFF/ 
? I* 

THESE COMMANDS 
♦TERMINATED* 



9et»aaa« 



The prompt cones back and 
EOT continues* 



< the break key Is pressed* 

EOT has stopped running and 
the operating systew Is In 
control of the system* 
Get the file* Aborting EOT 
«ay corrupt the edit file* 



READY* 
edt »aaa* 

BEGIN TEXT EDITING* 
? term/J/ 
? U*lf 

THESE COMMANDS DO NOT 
AFFECT THE EDIT FILE* BUT 
THEY 00 ASSIST THE USER IN 
USING EOT* 
f •r.teria?*? 



as c I i 



use the local terminator to 

override the global 

terminator* 

Change the character mode to 

ASCII* 



? a**l* 

ENTER TEXT* 
?/ The ASCII command does affect Input 
? inasmuch as loner case characters can 
? be used*/ 

READY* 

THESE COMMANDS DO NOT 
AFFECT THE EDIT FILE* BUT 
THEY DO ASSIST THE USER 
USING EOT* 

The ASCII command does affect input 
Inasmuch as lo^er case characters can 
be used* 

-END OF FILE- 
? normal 
? a** I** as ell 

ENTER TEXT* 
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the normal comniand changes ail 
characters to upper case* 
READY. 

THESE COMMANDS DO NOT 
AFFECT THE EDIT FILE, BUT 
THEY DO ASSIST THE USER IN 
USING EOT. 

The ASCII cofBwand does affect input 
Inasmuch as lo^er case characters can 
^ ^ u c ^ fi 

THE NORMAL COMMAND CHANGES ALL 
CHARACTERS TO UPPER CASE. 

-END OF FILE- 
? end 

END TEXT EDITING. 
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3.13.1 END COHHAHO lEMD) 

I 

The END cofnaiand terminates text editing (that ist exits 
froBi EOT program control) and returns control to the subsystem 
control language* The command format is: 

END 

The system will respond (when the input file is not 01 

END TEXT EDITING. 

3«13,2 STO? COMHAND (STOP) 

The user can also end text editing by typing STOP after the 
execution of an edit command* This immediately terminates the 
edit session and the terminal Is no longer under EDT control* 
In this case* the text file contents are unpredictable* and 
al I output f i I es can be lost* The error flag Is not set* 

This method of termination nould be used in situations 
where the contents of files are to be examined but are not 
required after the edit session* 

3*13*3 ABORT CQHNAND (ABORT) 

The ABORT command terminates the editor Just as the STOP 
command does* and it also sets the error flag* Thus* If the 
user enters EOT from a procedure file* EDT may be ended by 
STOP or ABORT* STOP wll I allow the procedure file to carry 
on* while ABORT will cause the procedure file to abort* 
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A 1.0 £ai.fil£SSili£S 



EOT supplies the fol lowing messages. There messages 
Indicate a condition that prevents processing of a command or 
are issued In the course of normal edit operation. 



ATTEMPTED REPLACE 



ON DIRECT FILE. 



BEGIN TEXT EDITING. 



COMMAND SUFFER TOO LONG. 



COMMAND CONTINUE? 



CONTROL CARD ERROR. 



DISREGARD PREVIOUS TEXT? 



A REPLACE command nas used 

on a direct access permanent 

file. 

ACTION - Make edit file a 

local file before editing. 



Inf ormat ive 
indicating the 
ready to begin 
commands. 
ACTION - None. 



command 

editor is 

accepting 



A series of commands of more 

than 150 characters was used 

in a CSd command. 

ACTION - re-enter the 

commands with less than 150 

characters. 

EOT inquiry as to whether or 

not an interrupted command 

should continue to be 

processed. 

ACTION - Respond with YES 

lYI or NO (N>. 

An 1 1 1 eg a 1 or inval I d 

parameter was specified on 

the control card. 

ACTION - Retry using correct 

parameters. 

EOT Inquiry as to whether or 
not the text that has been 
entered in response to a 
text-entering command should 
be retained or discarded. 



EOT - EXTENDED VERSION OF NOS EDIT 



Al-2 
06 AUG 80 



Al.O EOT MESSAGES 



-END OF FILE- 



END TEXT EDITING. 



ENTER TEXT. 



ENTER TEXT FILE NANE* 



FILE ALREADY PERMANENT. 



FILE ALREADY TRUNCATED. 



FILE AT LINE HUH8ER fi. 



ACTION - 
CY) or NO 



Respond 



with YES 



Inf ornatative message 
indicating that tli»e text 

file is positioned at end of 

file or end of file Mas 

encountered during a LIST or 
FIND cofBfliand. 
ACTION - None. 

Informative message 

indicating termination of 
EOT sess ion. 
ACTION - None. 

Requests entry of new or 
replacement text for ADD(SI> 
or CHANGECSI command. 
ACTION - Enter iine(s) of 
text to be processed 
(enclosed In deiim iters). 

Text file name lias not been 
passed with EOT call. 
ACTION - Enter text file 
name. 

A SAVE command vias attempted 

an 



with 



file name of 



existing file. 
ACTION - Use 
file name or 
command. 



dl f f erent 

REPLACE 



A LENGTH command was 
attempted on a file which 
has already been truncated 
by a LENGTH command. 
ACTION - Restore the file to 
Its original length and then 
use the LENGTH command. 



Text file 
posi t i oneii 

n. 

ACTION - None. 



Is currently 
at I ine number 



FILE NOT LONG ENOUGH. 



A LENGTH command gave line 
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FILE NOT TRUNCATED. 



FILE TOO BIG. 



IlLESAl COMMAND. 



litEGAt DELIMITER. 



ILLEGAL DELIMITER - REENTER 



ILLEGAL FILE NAME. 



numbers that were not in the 

f He. 

ACTION - Retry the LENGTH 

command *iiith correct line 

numbers* 

A LENGTH restore command ^as 
attempted on a file that has 
not been truncated. 
ACTION - Truncate file (with 
LENGTH commandl before 
trying to restore the file. 

A SAVE or REPLACE was 
attempted on a file that was 
too big for the indirect 
file size. 

ACTION - Reduce the size of 
the file or enter EDT lilth a 
direct file attached In 
write mode or make file a 
direct file when finished 
EDT. 

The command name entered is 
not a valid command. 
ACTION - Ensure that legal 
command Is entered. 

An illegal delimiter was 
used in response to the 
ENTER TEXT request from a 
local or remote batch Job. 
ACTION - Retry using correct 
del imi ter. 

TEXT. An Invalid delimiter was 
used in reponse to the ENTER 
TEXT request from a 
time-sharing job. 
ACTION - Retry using correct 
del Imi ter. 



The file name 

the text editor 

or REPLACE 

I I legal « 

ACTION - Specify 

name. 



passed 


with 


MERGE 


SAVE 


command 


is 



legal f i I e 
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INTERRUPT AT LINE n. 



INTERRUPT DISABLED. 



INTERRUPT ENABLED. 



LINE TOO LONG. 



Informative message 

indicating the current 
position of an Interrupted 
command • 
ACTION - None. 

An Informative message 
indicating that a program 
interrupt hIII not be 
processed by EOT* but will 
terminate EOT. 
ACTION - None. 

An Informative message 
indicating that a program 
Interrupt will be processed 
by EOT. 
ACTION - None. 

A line lengthened by a DEQL* 
CEOL or AC command became 
longer than 150 characters. 
ACTION -• Reduce line length 
to less than 150 
characters* 

The LOCAL command 
encountered problems 
attempting to make the 
string buffer local. 
ACTION ~ The string buffer 
cannot be made local by the 
NOS. Check for the reason 
outside of EOT. 



NERGE ERROR* SECONDARY FILE EMPTY. One of the following 

conditions exist. M) The 

file to be merged with the 

edit file is empty. (2) The 

file to be merged does not 
exist. 
ACTION - 



LOCAL FILE ERROR. 



PERHANENT FILE ERROR. 



Ver i f y merge fife. 



A NOS file error has 

occurred in a SAVE or 
REPLACE command. 

ACTION - Check outside of 

EDT for the reason for the 
aborted file request. 
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PHRASE NOT FOUND. 



READY* 



RESERVED FILE NAME. 



SEARCH COLUMNS ARE a b 



STRING BUFFER HAS NOT BEEN USED, 



TAB ? STOPS NONE. 



TAB c STOPS tX tZ ... tn 



WARNING! FILE HAS BEEN TRUNCATED. 
00 YOU WANT TO END ? 



r* LINES TO EOF. 



The specified 
was not found. 
ACTION - None. 



search strin* 



Inf ormat Ive 
indicating next 
be entered. 
ACTION - NONE. 



message 
command can 



Operation attemped on a file 
name reserved by EOT. 
ACTION - Choose a 
non-reserved file name. 



Inf ormat i ve 
indicating 
global search 
ACTION - None 



message 
the current 
coi umns. 



A LOCAL command xas 

attempted when the string 

buffer (used with EXTRACT) 

has not been used. 

ACTION - Use EXTRACT before 

LOCAL. 

No tab stops are currently 
estabi i shed. 
ACTION - None. 

EOT tab character 'c* and 
stops issued in response to 
LISTAB command. 
ACTION - None. 



A warning message when the 
END command ts issued to 
Inform the user that the 
text file has been truncated 
with the LENGTH command. 
ACTION - Respond YES CYI or 
NO INK. 

Informative message 

indicating number of lines 
in text file before 
end-of-flle. 

ACTION - None. 
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n LINES TO INTERRUPT. 



n OCCURRENCES OF PHRASE FOUND, 



comwand SYMTAX ERROR* 



Inforwatlve message 

indicating the number of 
lines that were processed 
before the user teriralnated a 
cofRfliand* 
ACTION - None. 

End-of^flle was encountered 
before number of iterations 
specified in command Mere 
compi eted* 
ACTION - None* 

Improper syntax used with 
text editor coffimand* 
ACTION - Retry using correct 
syntax* 
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